Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/foedusprogramme/gramophone/llms.txt

Use this file to discover all available pages before exploring further.

Gramophone is distributed through three channels. All three carry the same application ID (org.akanework.gramophone) but are signed with different certificates — see Verify the app signature below.

​
Choose an installation source

F-Droid is a free and open-source Android app repository. Gramophone is built and signed by the F-Droid infrastructure from the public source code, making it the most verifiable option.To install:
  1. Install the F-Droid client on your device if you haven’t already.
  2. Open the F-Droid app and search for Gramophone, or visit the package page directly: f-droid.org/packages/org.akanework.gramophone
  3. Tap Install.
F-Droid releases may lag behind GitHub releases by a few days while the build infrastructure processes the new version.

​
Verify the app signature

You can verify that the APK you installed matches the genuine Gramophone release by checking the signing certificate SHA-256 fingerprint. The fingerprint depends on where you got the app.
SourceCertificate SHA-256
GitHub releases, F-Droid, IzzyOnDroidf451197ad7b80bd1bc981ba38a2c49d471856fb38bcc333676d6e8f8f3ce5d6e
Google Play178869b0f9130d145b53404df4d4e5e311095406cb3c51a3e7a4b03bb3e87786
To check the fingerprint on your device, use a package information app or run the following with ADB: 
adb shell pm get-app-links --user 0 org.akanework.gramophone
For deeper verification, use apksigner verify --print-certs against the downloaded APK file.

​
Beta access

Beta builds and development previews are distributed through Telegram before they reach the app stores. Beta builds may contain unfinished features or bugs. Use them if you want to test new functionality early and provide feedback.

​
Permissions

Gramophone requests the following permissions on first launch:
PermissionWhy it is needed
Read audio files (READ_MEDIA_AUDIO)Required to scan your music library via MediaStore. Without this, no songs will appear.
Read media files (READ_EXTERNAL_STORAGE, Android 9 and below)Same purpose as above on older Android versions.
Photos and videos (READ_MEDIA_IMAGES, optional)Used only to display album artwork (“enhanced album covers” feature). This feature is disabled by default and can be enabled in Settings. No images are uploaded or processed outside the app.
Gramophone does not request internet access, location, contacts, microphone, or any other sensitive permissions.

​
Supported audio formats

Gramophone can play the following formats: MP3, FLAC, OGG, OPUS, M4A, MKA, WAV, MIDI, and ALAC.
Gramophone relies on Android system codecs for most formats, so support varies by device and Android version:
  • OPUS files are only scanned by MediaStore on Android 10 and later (rename .opus to .ogg for Android 6+ compatibility).
  • int32 (32-bit) FLAC requires Android 14 or later.
  • xHE-AAC requires Android 9 or later.
  • Dolby Digital (AC-3/E-AC-3/AC-4) requires a device with licensed Dolby decoders.
  • ALAC works on all supported Android versions via Gramophone’s built-in Java decoder.
See the FAQ for more details.

Build docs developers (and LLMs) love

Get started for freeTalk to us