CLI reference#
veemeeter open the mixer window (starts the daemon if needed)
veemeeter gui [--no-spawn] [--no-tray]
veemeeter tray [--no-spawn] [--wait] Mimi in the system tray only, no window
veemeeter daemon [--config <path>]
veemeeter ctl [--json] <command> …
veemeeter ctl talks to the running daemon over a Unix socket at
$XDG_RUNTIME_DIR/veemeeter.sock (one JSON object per line). It is made for
keyboard shortcuts, status bars and scripts.
Strip ids
Commands take strip ids, not names: hi1, vi2, a1, b1…
veemeeter ctl status lists them.
veemeeter daemon#
Runs the audio engine in the foreground. Usually started by the systemd user
service. --config <path> overrides the default
$XDG_CONFIG_HOME/veemeeter/config.toml.
ctl commands#
status#
Shows the PipeWire version, every strip (volume, routes, muted / default / device offline flags), the available devices and the applications currently playing or recording (with their numeric ids).
volume <id> <level|up|down> [step]#
veemeeter ctl volume vi1 0 # back to unity
veemeeter ctl volume vi1 -- -6 # −6 dB (put `--` before a negative number)
veemeeter ctl volume hi1 6dB # a "dB" suffix is accepted
veemeeter ctl volume vi1 up # 3 dB louder
veemeeter ctl volume vi1 down 1.5 # 1.5 dB quieter
veemeeter ctl volume b1 off # fader to −∞
A number is always an absolute level, clamped to −60 (off) … +12 dB.
Use up / down (default step 3 dB) for relative changes, e.g. on
keyboard shortcuts.
mute <id> [on|off|toggle]#
on/off also accept true/false, 1/0, yes/no.
route <from> <to> [on|off|toggle]#
veemeeter ctl route vi1 b1 on # send Desktop into the virtual mic
veemeeter ctl route vi1 b1 # toggle
<from> is an input, <to> an output.
default <id>#
Makes a strip the system default output (virtual input, hardware output) or
default microphone (virtual output, hardware input — e.g.
veemeeter ctl default hi1). Cables cannot be the default.
add <kind> <name> [--device <node>] [--layout <layout>]#
veemeeter ctl add vi Music
veemeeter ctl add b Stream
veemeeter ctl add c "OBS to Discord"
veemeeter ctl add a Headset --device alsa_output.usb-…analog-stereo
veemeeter ctl add hi "Line in" --layout mono
kind |
Strip |
|---|---|
hi |
hardware input |
vi |
virtual input |
a |
hardware output (A bus) |
b |
virtual output (B bus) |
c |
virtual cable (one app plays into it, another records from it) |
--device takes a PipeWire node name (see ctl status, DEVICES).
--layout is one of mono, stereo, quad, 5.1, 7.1 (default stereo).
remove <id> · rename <id> <name>#
move <app> <to>#
<app> is the numeric id shown under APPLICATIONS in ctl status.
send <from> <to> <db>#
veemeeter ctl send vi2 b1 -- -12 # Music 12 dB quieter in the virtual mic only
veemeeter ctl send vi2 b1 0 # back to a straight route
Level of one route (a send), −60 … +12 dB, on top of the input's fader. The level is kept while the route is off.
eq <id> [on|off|toggle|<gains>]#
veemeeter ctl eq hi1 # toggle the equalizer
veemeeter ctl eq hi1 3,0,-2,1.5,0 # set the five bands (and turn it on)
Gains are in dB for 80 Hz, 250 Hz, 1 kHz, 4 kHz and 10 kHz (−12 … +12).
Write -- -3,0,0,0,0 when the list starts with a minus sign.
denoise <id> [on|off|toggle]#
Fails with a hint when the RNNoise plugin is not installed.
quit#
Stops the daemon; every VeeMeeter device disappears. With the systemd
service, prefer systemctl --user stop veemeeter (otherwise the service
manager may restart it, depending on its settings).
Keyboard shortcuts#
ctl returns as soon as the daemon has applied the change, so it is made for
global shortcuts. Bind it in your desktop:
Settings → Keyboard → Custom shortcuts → command
veemeeter ctl mute hi1.
veemeeter ctl --json status is handy for status bars (waybar, polybar):
read strips[].mute, strips[].volume_db, strips[].routes.
Exit status#
0 on success. On failure ctl prints veemeeter: <reason> to stderr and
exits non-zero. If the daemon is not running you get a hint to start it with
veemeeter daemon or systemctl --user start veemeeter.
Bind it to keys
Media keys are just commands. For example in Hyprland:
bind = , XF86AudioMicMute, exec, veemeeter ctl mute hi1