Skip to content

Commit 97912f4

Browse files
committed
chore: add normalization details to README
1 parent 060b678 commit 97912f4

File tree

1 file changed

+21
-1
lines changed

1 file changed

+21
-1
lines changed

README.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ An example Docker Compose configuration for PulseAudio is available [here](/dock
2828

2929
### Using Brew
3030

31-
You can also install go-librespot [using Brew](https://formulae.brew.sh/formula/go-librespot)
31+
You can also install go-librespot [using Brew](https://formulae.brew.sh/formula/go-librespot)
3232
on macOS and Linux (thanks @kriive):
3333

3434
```shell
@@ -147,6 +147,26 @@ Various configurations for volume control are available:
147147
4. **External volume with mixer**: Device volume is synchronized with Spotify volume, output samples are not volume
148148
dependant, volume changes are not applied to the ALSA mixer
149149

150+
### Audio normalization
151+
152+
go-librespot implements audio normalization according to Spotify's standards, which targets **-14 dB LUFS** (Loudness
153+
Units relative to Full Scale) based on the **ITU-R BS.1770** standard.
154+
[Source](https://support.spotify.com/us/artists/article/loudness-normalization/)
155+
156+
Normalization can be configured with the following options:
157+
158+
```yaml
159+
normalisation_disabled: false # Whether to disable normalization (default: false)
160+
normalisation_use_album_gain: false # Whether to use album gain instead of track gain (default: false)
161+
normalisation_pregain: 0 # Pregain in dB to apply before normalization (default: 0)
162+
```
163+
164+
The pregain is applied on Spotify's -14 dB LUFS target. Spotify suggests the following presets for pregain:
165+
166+
- Loud: -11 dB LUFS, apply a pregain of +3 dB
167+
- Normal: -14 dB LUFS, apply a pregain of 0 dB
168+
- Quiet: -19 dB LUFS, apply a pregain of -5 dB
169+
150170
### Additional configuration
151171

152172
The following options are also available:

0 commit comments

Comments
 (0)