/InnerTune

A Material 3 YouTube Music client for Android

Primary LanguageKotlinGNU General Public License v3.0GPL-3.0

InnerTune

Make your own music library with any song from YouTube Music.
No ads, free, and simple.

Get it on F-Droid

Latest release License Downloads

Note

1. The project is currently in an unstable stage, so there should be many bugs. If you encounter one, please report by opening an issue.

2. The icon of this app is temporary. It will be changed in the future.

With this app, you're like getting a free music streaming service. You can listen to music from YouTube Music and build your own library. What's more, songs can be downloaded for offline playback. You can also create playlists to organize your songs. The aim of InnerTune is to enable everyone to listen to music at no cost by an easy-to-use, practical and ad-free application.

Warning

If you're in region that YouTube Music is not supported, you won't be able to use this app unless you have proxy or VPN to connect to a YTM supported region.

Features

YouTube

  • Play songs without ads
  • Browse almost any YouTube Music page
  • Search songs, albums, videos and playlists from YouTube Music
  • Open YouTube Music links

Library

  • Save songs, albums and playlists in local database
  • Download music for offline playback
  • Like songs
  • local playlist management
  • Add links to your favorite YouTube Music playlists
  • Export downloaded songs via SAF

Player

  • Material design player
  • Lockscreen playback
  • Cache songs
  • (Synchronized) lyrics
  • Skip silence
  • Audio normalization
  • Stat for nerds
  • Persistent queue

Other

  • Custom themes
  • Dark theme
  • Localization
  • Proxy
  • Backup & restore
  • Support Android Auto

Screenshots

Installation

You can install InnerTune using the following methods:

  1. Download the APK file from GitHub Releases.
  2. Add IzzyOnDroid to your F-Droid repos following the instruction, and you can search for this app and receive updates.
  3. If you want to have bug fixes or enjoy new features quickly, install debug version from GitHub Action at your own risk and remember to backup your data more frequently.
  4. Clone this repository and build a debug APK.

How to get updates?

  1. F-Droid application.
  2. GitHub + Obtainium (beta)

FAQ

Q: How to scrobble music to LastFM, LibreFM, ListenBrainz or GNU FM?

Use other music scrobbler apps. I recommend Pano Scrobbler.

Q: How to export downloaded song files?

InnerTune supports SAF. You can find the provider in Android native file manager. You can also use Material Files with instruction (recommended).

Q: Why InnerTune isn't showing in Android Auto?

  1. Go to Android Auto's settings and tap multiple times on the version in the bottom to enable developer settings
  2. In the three dots menu at the top-right of the screen, click "Developer settings"
  3. Enable "Unknown sources"

Contribution

Contributing Translations

App

  1. Have a fork of this project.
  2. If you have Android Studio, right click on the app/src/main/res/values folder, select "New"->"Values Resource File". Input strings.xml as file name. Select "Locale", click ">>", choose your language and region, and click "OK".
  3. If not, create a folder named values-<language code>-r<region code> under app/src/main/res. Copy app/src/main/res/values/strings.xml to the created folder.
  4. Replace each English string with the equivalent translation. Note that lines with translatable="false" should be ignored.
  5. (Recommended) Build the app to see if something is wrong.
  6. Make a pull request with your changes. If you do step 5, the process of accepting your PR will be faster.

Fastlane (App Description and Changelogs)

Follow the fastlane instruction to add your language and create a pull request.