Configuration#
VeeMeeter keeps its setup in ~/.config/veemeeter/config.toml
($XDG_CONFIG_HOME/veemeeter/config.toml). The daemon writes it every time
you change something in the window or with ctl, so most people never edit
it by hand.
Hand edits
The daemon reads the file at start-up. Edit it while the daemon is stopped (or restart it afterwards), otherwise your edit may be overwritten by the next change.
Format#
The file is a list of [[strip]] tables, in display order:
[[strip]]
id = "hi1"
kind = "hardware_in"
name = "Microphone"
channels = ["FL", "FR"]
volume_db = 0.0
mute = false
routes = ["b1"]
[[strip]]
id = "vi1"
kind = "virtual_in"
name = "Desktop"
channels = ["FL", "FR"]
volume_db = 0.0
mute = false
routes = ["a1"]
primary = true
[[strip]]
id = "vi2"
kind = "virtual_in"
name = "Voice chat"
channels = ["FL", "FR"]
volume_db = 0.0
mute = false
routes = ["a1"]
[[strip]]
id = "a1"
kind = "hardware_out"
name = "Speakers"
channels = ["FL", "FR"]
volume_db = 0.0
mute = false
[[strip]]
id = "b1"
kind = "virtual_out"
name = "Virtual Mic"
channels = ["FL", "FR"]
volume_db = 0.0
mute = false
primary = true
Keys#
| Key | Type | Applies to | Meaning |
|---|---|---|---|
id |
string | all | Unique id, lowercase letters and digits (≤ 16): hi1, vi1, a1, b1… Used by ctl and in routes. |
kind |
string | all | hardware_in, virtual_in, cable, hardware_out or virtual_out. |
name |
string | all | Display name, also shown as the device name in other apps (≤ 64 characters). |
device |
string | hardware | PipeWire node.name of the real device. Missing = no device. |
channels |
list | all | Channel positions. Default ["FL", "FR"]. |
volume_db |
float | all | Fader, −60 (off) … +12. Default 0.0. |
mute |
bool | all | Default false. |
routes |
list | inputs | Ids of the outputs this input is sent to. |
primary |
bool | virtual | System default device. At most one virtual input and one virtual output. |
| sends | table | inputs | Send level per routed output in dB, e.g. sends = { b1 = -12.0 }. Missing = 0 dB (straight link). |
| fx | table | any | Effects, see below. Omitted while everything is off. |
Effects ([strip.fx])#
[[strip]]
id = "hi1"
# …
[strip.fx]
eq = true # 5-band equalizer on
gains = [-3.0, 1.5, 0.0, 3.5, 2.0] # dB at 80 Hz, 250 Hz, 1 kHz, 4 kHz, 10 kHz
denoise = true # RNNoise noise suppression
| Key | Type | Meaning |
|---|---|---|
eq |
bool | Equalizer on. Bands: low shelf 80 Hz, peaks at 250 Hz, 1 kHz and 4 kHz, high shelf 10 kHz. |
gains |
5 floats | Band gains in dB, clamped to −12 … +12 (0.1 dB steps). Kept while eq is off. |
denoise |
bool | Noise suppression. Needs the RNNoise LADSPA plugin (librnnoise_ladspa.so); ignored while it is missing. |
Effects run inside the daemon (PipeWire filter-chain): after the fader for
inputs and hardware outputs, before the virtual mic for virtual outputs.
Channel layouts#
| Layout | channels |
|---|---|
| Mono | ["MONO"] |
| Stereo | ["FL", "FR"] |
| Quad | ["FL", "FR", "RL", "RR"] |
| 5.1 | ["FL", "FR", "FC", "LFE", "RL", "RR"] |
| 7.1 | ["FL", "FR", "FC", "LFE", "RL", "RR", "SL", "SR"] |
Validation#
Invalid values are fixed when the file is loaded, never fatal:
- duplicate or invalid ids are dropped; at most 32 strips are kept;
- names are trimmed; an empty name becomes the id;
volume_dbis clamped to −60 … +12;routespointing to unknown outputs are removed (and ignored on outputs);deviceis ignored on virtual strips; extraprimary = trueare cleared.
Finding device names
veemeeter ctl status prints a DEVICES section with each device's
description and node name, ready to paste into device = "…".
Starting fresh#
Stop the daemon, delete config.toml, start it again: the first-run setup
above is recreated.