Configure audio processing, volume normalization, and codec behavior. Where to find: three-dot menu → Settings → AudioDocumentation 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.
Miscellaneous
ReplayGain
Opens the ReplayGain sub-screen. See the ReplayGain settings section below for full details.MP3 index seeking
Preference key:mp3_index_seeking · Default: Off
When enabled, Gramophone reads the entire MP3 file into memory to build an accurate seek index, rather than relying on the Xing header for variable bitrate (VBR) seeking.
When should I enable this?
When should I enable this?
Most well-formed VBR MP3 files include a Xing header, so this option is not needed in the majority of cases. Enable it only if seeking in a specific VBR MP3 file produces incorrect position jumps and you have confirmed the file lacks a Xing header.If the Xing header is missing and this setting is off, Gramophone falls back to constant bitrate (CBR) seeking, which may be inaccurate for VBR files.
Boost
The Boost category is only shown on devices where post-amplification is available (PostAmpAudioSink.isVolumeAvailable or PostAmpAudioSink.isDpeAvailable).
Boost gain
Preference key:rg_boost_gain · Default: 0 dB · Range: 0 – 15 dB
Increases the output volume of all audio above the device volume level. This lets you match Gramophone’s perceived loudness to other apps such as games, while still benefiting from ReplayGain normalization.
If your device volume is already near 100%, Boost will have no additional effect.
ReplayGain settings
Accessed from Audio → ReplayGain. Gramophone supports full ReplayGain 2.0.Mode
Preference key:rg_mode · Default: Disabled
| Value | Behavior |
|---|---|
| Disabled | ReplayGain tags are ignored; playback volume is unmodified |
| All tracks equal loudness | Applies track gain to normalize all songs to a consistent loudness level |
| Preserve album dynamics | Applies album gain so that relative loudness differences within an album are preserved |
| Smart | Automatically applies album gain when playing songs from the same album consecutively, and track gain otherwise |
“Smart” mode preserves album dynamics only when you listen to an album from start to finish. Shuffling or mixing songs from different albums switches back to per-track normalization automatically.
Enable DRC
Preference key:rg_drc · Default: On
Uses Dynamic Range Compression as clipping protection when ReplayGain would push the output above 0 dBFS.
When DRC is off, Gramophone reduces volume instead. This keeps individual tracks from clipping but breaks normalization — songs will no longer play at equal loudness levels.
Pre amp
Preference key:rg_rg_gain · Default: 0 dB · Range: −15 – 15 dB
Adjusts the overall volume for songs that have ReplayGain tags, before the ReplayGain gain value is applied. Increasing this can raise the perceived loudness, but higher values increase the risk of clipping.
Attenuation (no RG)
Preference key:rg_no_rg_gain · Default: 0 dB · Range: 0 – −15 dB
Reduces the volume for songs that do not have ReplayGain tags. Use this to prevent untagged tracks from playing noticeably louder than tagged tracks.