Repository files navigation

日本語

A sane music player built with media3 and material design library that is following android's standard strictly.

• Up-to-date material 3 design
• Monet themed icon on Android 12+
• Dynamic player UI monet color
• View and play your favorite music
• Search your favourite music
• Uses MediaStore to quickly access music database
• Synced lyrics
• Read-only Playlist support

You can download the latest stable version of the app fromGitHub releases, or fromF-Droid.

Beta versions and sneak peeks are available in thetelegram channel orchat.

To build this app, you will need the latest beta version ofAndroid Studio and a fast network.

Gramophone includes certain dependencies such as media3 as git submodule. Make sure you download git submodules by runninggit submodule update --init --recursive before trying to build Gramophone.

Gramophone has a package type that indicates the source of the application package. Package type string is extracted from an external file namedpackage.properties.

Simply open your favorite text editor, typereleaseType=SelfBuilt, and save it in the root folder of the repository aspackage.properties.

After this, launch Android Studio and import your own signature. You should be able to build Gramophone now.

This project is licensed under the GNU General Public License v3.0 - see theLICENSE file for details.

• For bug reporting:Telegram
• GitHub/F-Droid/IzzyOnDroid certificate SHA-256 digest: f451197ad7b80bd1bc981ba38a2c49d471856fb38bcc333676d6e8f8f3ce5d6e
• Play Store certificate SHA-256 digest: 178869b0f9130d145b53404df4d4e5e311095406cb3c51a3e7a4b03bb3e87786

Why can't I see songs shorter than 60 seconds?Gramophone hides songs shorter than 60 seconds by default. You can change it inThree dots > Settings > Behaviour (set the setting to 0 to show all songs).

I changed the min length setting, but some songs are still missing!Make sure you haven't excluded the folder inBehaviour > Folder blacklist.Then, try to reboot your phone, then wait a few minutes (this will rescan the system-wide media database Gramophone uses to find songs).If it's still not visible, your system version may not support scanning this file extension: this most commonly is observed for .opus, which will only be scanned since Android 10 (pro tip: rename your .opus file to .ogg, and it will be detected on Android 6 and later).

My song isn't playing! / My song is playing, but it's completely silent, yet the volume is turned up!Please note that Gramophone relys on system media codecs to make the app smaller. This means

• int32 (32-bit) FLAC files will only work on Android 14 or later
• FLAC files often do work even on versions prior to Android 8, but are only officially supported on Android 8 or later
• xHE-AAC files in general will only work on Android 9 or later
• Dolby Digital (AC-3) / Dolby Digital Plus (E-AC-3) requires a device that has licensed decoders for these formats

There is one exception: ALAC has an extremely lightweight Java decoder available which is included in Gramophone, hence, ALAC files can be played back even without system ALAC decoder.

SongSync