Gramophone uses Android’s MediaStore API to read music directly from your device’s storage. There is no manual import step — open the app and your library is ready.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.
How scanning works
MediaStore is a system-wide media database maintained by Android. Whenever you add, remove, or modify audio files, Android updates MediaStore in the background. Gramophone reads from this database, so your library always reflects what is on your device without any manual refresh.If you add files and they do not appear immediately, try rebooting your device and waiting a few minutes. This forces Android to rescan the media database. On Android 10 and later,
.opus files are scanned natively; on older versions you can rename them to .ogg to ensure they are picked up.Browsing categories
Your library is organized into seven browsing categories:Songs
All tracks on your device in a flat list.
Albums
Tracks grouped by album, with cover art.
Artists
Tracks grouped by artist, with per-artist album views.
Genres
Tracks grouped by genre tag.
Folders
Browse music by directory structure on your filesystem.
Playlists
Read-only playlists stored on your device.
List and grid views
Most library categories support toggling between a list view and a grid view. Grid view is particularly useful for Albums and Artists where cover art is a helpful visual anchor.Sort options
Each category exposes a sort menu. The available sort types depend on the category, and are drawn from the following options:| Sort type | Description |
|---|---|
| Title (A–Z / Z–A) | Alphabetical by track, album, or category title |
| Artist (A–Z / Z–A) | Alphabetical by artist name |
| Album artist (A–Z / Z–A) | Alphabetical by album artist |
| Album year (newest / oldest) | Chronological by album release year |
| Artist + year | Artist name, then release year within each artist |
| Release date (newest / oldest) | By individual track release date |
| Add date (newest / oldest) | By date the file was added to MediaStore |
| Modified date (newest / oldest) | By file last-modified date |
| File path (A–Z / Z–A) | Alphabetical by full filesystem path |
| Disc and track number | In-album ordering by disc, then track number |
| Size (largest / smallest) | By number of tracks in a group |
Search
Tap the search icon to open the search bar. Gramophone searches across track titles, album names, and artist names simultaneously and displays results grouped by category.Playlists
Playlist support is read-only. Gramophone reads playlists that are already stored on your device and recognized by MediaStore. Creating or editing playlists from within Gramophone is not supported.Filtering and blacklisting
Minimum song duration filter
Minimum song duration filter
Gramophone hides tracks shorter than 60 seconds by default. This prevents short sound effects or interludes from cluttering your library.To change the threshold, go to Settings > Behaviour and adjust the minimum song length. Set it to
0 to show all tracks regardless of duration.Folder blacklist
Folder blacklist
You can exclude specific folders from your library. Navigate to Settings > Behaviour > Folder blacklist and add any directories you want Gramophone to ignore.