Skip to content

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#

veemeeter ctl status
veemeeter ctl --json status   # machine-readable

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]#

veemeeter ctl mute hi1          # toggle (default)
veemeeter ctl mute hi1 on

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>#

veemeeter ctl default vi2        # apps now play into "Voice chat"

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>#

veemeeter ctl rename vi2 Discord
veemeeter ctl remove b2

move <app> <to>#

veemeeter ctl move 87 vi2        # move app stream #87 to "Voice chat"

<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]#

veemeeter ctl denoise hi1 on         # RNNoise on the microphone

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:

bind = SUPER, M, exec, veemeeter ctl mute hi1
bind = SUPER, Prior, exec, veemeeter ctl volume vi1 up
bind = SUPER, Next, exec, veemeeter ctl volume vi1 down
bindsym $mod+m exec veemeeter ctl mute hi1
bindsym $mod+Prior exec veemeeter ctl volume vi1 up
bindsym $mod+Next exec veemeeter ctl volume vi1 down

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