equalizer_set
Adjust audio equalizer bands, gain, preamp, and normalization to shape playback sound; set a full ten-band curve in one call or switch the EQ on/off without losing it.
Instructions
Adjust the equaliser. Set one band with band (0-9, low to high) plus gain in dB, or the whole curve at once with bands. enabled switches the equaliser in and out without discarding the curve, normalize evens out quiet dialogue against loud action, and preamp makes headroom so boosted bands don't clip. Gains are clamped to ±12 dB. Every change rebuilds mpv's audio filter chain, so set a whole curve in one call rather than nine.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "equalizer_set"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| band | No | Band index 0-9: 31, 62, 125, 250, 500, 1000, 2000, 4000, 8000, 16000 Hz | |
| gain | No | Gain in dB for that band, -12 to 12 | |
| bands | No | All ten gains in dB, low frequency first | |
| preamp | No | Preamp in dB, -20 to 12 | |
| enabled | No | Switch the equaliser on or off, keeping the curve | |
| normalize | No | Dynamic loudness normalisation |