Skip to content

Usage with i3blocks

Beau Hastings edited this page Dec 30, 2025 · 3 revisions

i3-volume can be used with i3blocks as a blocklet. The following is a sample configuration section for your ~/.config/i3blocks/config:

[i3volume]
label=
command=~/i3-volume/volume output i3blocks
interval=once
signal=10
color=#b8bb26
separator_block_width=10
markup=pango

Note: You can also use the -o flag: ~/i3-volume/volume -o i3blocks (both syntaxes work).

Note: the label key is not blank, the character may appear invisible on this page.

Mouse Wheel Support

i3-volume automatically supports mouse wheel scrolling when used with i3blocks. Simply scroll up or down on the volume block in your i3bar to adjust the volume:

  • Scroll Up (Button 4): Increases volume
  • Scroll Down (Button 5): Decreases volume

The wheel command accumulates small changes for smooth scrolling - volume changes are applied when the accumulated delta reaches 1%, providing a natural scrolling experience.

No additional configuration is needed - the mouse wheel support works automatically when i3blocks passes the BLOCK_BUTTON environment variable.

Clone this wiki locally