Skip to content

Usage with i3status rust

Beau Hastings edited this page Jan 5, 2026 · 4 revisions

i3-volume can be used with i3status-rust as a custom block. The following is a sample configuration section for your ~/.config/i3status-rust/config.toml:

[[block]]
block = "custom"
signal = 10
interval = "once"
# Material icons: ,󰕾,󰕿,󰖀
command = "~/i3-volume/volume -j \",󰕾,󰕿,󰖀\" output \"%i %n %c%v %p \n\""
# FontAwesome icons: 󰖁,,,
# Example icons: 🔇,🔊,🔊,🔉

[[block.click]]
button = "left"
cmd = "~/i3-volume/volume mute"

[[block.click]]
button = "wheel_up"
cmd = "~/i3-volume/volume up"

[[block.click]]
button = "wheel_down"
cmd = "~/i3-volume/volume down"

Note: Replace ~/i3-volume/volume with the actual path to your i3-volume script.

If using i3-volume's config (eg: ~/.config/i3-volume/config):

STATUSLINE="i3status-rs"
SIGNAL="SIGRTMIN+10"

If using one of the example keybinding configs in the Installation instructions, in your ~/.config/i3/config:

set $statuscmd i3status-rs
set $statussig SIGRTMIN+10

NOTE $statuscmd is the name of the statusbar executable, NOT the path to it. i3-volume uses pkill to send signals to the process using this name.

Clone this wiki locally