Skip to main content

Documentation Index

Fetch the complete documentation index at: https://rockboxzig.mintlify.app/llms.txt

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

The rbcodec DSP pipeline runs between the codec output and the active sink. All of these are bypassable; turn anything off by zeroing its enable flag.

Crossfeed

Mixes a delayed and filtered portion of one channel into the other to simulate the spatial cues you’d get from loudspeakers. Particularly useful on headphones with hard-panned mixes (older rock/jazz).
SettingStorageRangeDefault
Typecrossfeedoff / meier / customoff
Direct gaincrossfeed_direct_gain−60..0 dB (step 5)−15 dB
Cross gaincrossfeed_cross_gain−120..−30 dB−60 dB
HF attenuationcrossfeed_hf_attenuation−240..−60 dB−160 dB
HF cutoffcrossfeed_hf_cutoff500..2000 Hz700 Hz
Crossfeed can cause output distortion if its settings result in a combined level that is too high.

Haas surround

Adds an adjustable delay between channels to widen the stereo image. Four auxiliary controls move the perceived stage back toward the centre.
SettingStorageRangeDefault
Enablesurround_enabled0 / 5 / 8 / 10 / 15 / 30 ms0 (off)
Balancesurround_balance0..99 %35 %
f(x1) HF cutsurround_fx1600..8000 Hz (step 200)3400 Hz
f(x2) LF cutsurround_fx240..400 Hz (step 40)320 Hz
Side onlysurround_method2boolfalse
Dry/wet mixsurround_mix0..100 %50 %

Perceptual Bass Enhancement (PBE)

Group-delay correction plus a biophonic EQ to boost low-end perception.
SettingStorageRangeDefault
Strengthpbe0..100 % (step 25)0 % (off)
Precutpbe_precut−4.5..0 dB (step 0.1)−2.5 dB

Auditory Fatigue Reduction (AFR)

Reduces energy in frequency bands the human ear is most sensitive to — helpful for long listening sessions.
SettingValuesDefault
AFR enableoff / weak / moderate / strongoff

Compressor

Reduces dynamic range so quiet passages stay audible without loud passages clipping.
SettingStorageValues / rangeDefault
Threshold.thresholdoff / −3 / −6 / −9 / −12 / −15 / −18 / −21 / −24 dBoff
Makeup gain.makeup_gainoff / autoauto
Ratio.ratio2:1 / 4:1 / 6:1 / 10:1 / limit2:1
Knee.kneehard / softsoft
Attack time.attack_time0..30 ms (step 5)5 ms
Release time.release_time100..1000 ms (step 100)500 ms
[compressor_settings]
threshold    = -24
makeup_gain  = 0
ratio        = 4
knee         = 1
release_time = 300
attack_time  = 5

Dithering

Most decoders work at higher than 16-bit precision; dithering adds a small shaped noise signal before truncation so the residual is uniform rather than signal-correlated. Most useful with classical music and other high-dynamic-range material.
dithering_enabled = true
  • Algorithm: high-pass triangular distribution (HPTPDF)
  • Noise shaper: third order, biased above ~10 kHz