Scroll to navigation

pipemixer.ini(5) File Formats pipemixer.ini(5)

NAME

pipemixer.ini - configuration file for pipemixer(1)

DESCRIPTION

The pipemixer.ini file configures the behavior and appearance of pipemixer.

pipemixer will search for a configuration file in the following locations:

  • $XDG_CONFIG_HOME/pipemixer/pipemixer.ini
  • $HOME/.config/pipemixer/pipemixer.ini, if XDG_CONFIG_HOME is unset.

SECTION: main

General options.

volume-step

Volume change step in percentage (1 means 1%). Default: 1.

volume-min, volume-max

Max and min volume that can be set with pipemixer. Default: 0, 150.

wraparound

Whether scrolling through nodes will continue at the top after reaching the bottom and vice versa. Default: false.

SECTION: binds

Configure keybindings. Format is action=key. Each action can be bound to multiple keys. Key can be specified in several ways:

  • All printable ASCII/Unicode characters.
    Example: tab-next=t
  • Special keys: up, down, left, right, enter, tab, backtab, space, backspace, escape.
    Example: tab-prev=backtab
  • Arbitrary keycodes with code:N, where N is a decimal number. If N is prefixed with 0x, it is interpreted as hexadecimal instead.
    Example: quit=code:185

focus-down, focus-up

Navigate node list.

focus-first, focus-last

Focus first or last node.

volume-up, volume-down

Adjust volume.

tab-next, tab-prev

Cycle forward/backward through tabs.

tab-playback, tab-recording, tab-input-devices, tab-output-devices

Switch to specific tab.

mute-toggle, mute-enable, mute-disable

Set mute state for selected node.

channel-lock-toggle, channel-lock-enable, channel-lock-disable

Set channel lock for selected node.

volume-set-N

Set volume of selected node to N%.

select-route

Enter route selection menu on nodes that support it.

confirm-selection, cancel-selection

Self-explanatory. Applies to menu selection mode.

quit

Exit application.

unbind

Unbind a key from any action.

SECTION: interface

Configure various UI elements.

routes-separator

String that separates routes on nodes that have them.

border-left, border-right, border-top, border-bottom,
border-top-left, border-top-right, border-bottom-left, border-bottom-right

Characters that make up border around each node.

volume-frame-top-left, volume-frame-top-right,
volume-frame-bottom-left, volume-frame-bottom-right,
volume-frame-center-left, volume-frame-center-right,
volume-frame-mono-left, volume-frame-mono-right,
volume-frame-focus

Characters that make up frame around per-channel volume bars.

bar-empty-char, bar-full-char

Characters for drawing volume bars.

EXAMPLE

[main]
volume-step=5
[borders]
left=|
right=|
top=-
bottom=-
top-left=+
top-right=+
bottom-left=+
bottom-right=+
center-right=|
center-left=|
[binds]
volume-up=+
volume-down=-
volume-set-10=1
volume-set-20=2
volume-set-30=3
volume-set-40=4
volume-set-50=5

SEE ALSO

pipemixer(1)

June 2025 0.1.0