i3-volume

Volume control and volume notifications for i3wm

Installation

Requirements

i3wm - A better tiling and dynamic window manager
notify-osd - Canonical's on-screen-display notification agent

Conflicts

dunst will not work with i3-volume's notifications. If you wish to use notifications you must use notify-osd.

Note: The Ubuntu repository provided by sur5r for the stable i3 package will install dunst. The dunst daemon cannot be running for notifications to go to notify-osd! killall -9 dunst or remove dunst with sudo apt-get remove dunst

Guide

Clone this repository: git clone https://github.com/hastinbe/i3-volume.git ~/i3-volume

Edit the following example and append it to your ~/.config/i3/config:

## Volume control

# Path to volume control, without trailing slash
set $volumepath ~/i3-volume

# Command for the status line (used with -t, must also use -u)
#   ie: i3blocks, i3status
set $statuscmd i3status

# Signal used to update the status line (used with -u, must also use -t)
#   i3blocks uses SIGRTMIN+10 by default
#   i3status uses SIGUSR1 by default
set $statussig SIGUSR1

# Amount to increase/decrease volume as a percentage (used with -i, -d)
set $volumestep 5

bindsym XF86AudioRaiseVolume exec $volumepath/volume -i $volumestep -n -t $statuscmd -u $statussig
bindsym XF86AudioLowerVolume exec $volumepath/volume -d $volumestep -n -t $statuscmd -u $statussig
bindsym XF86AudioMute exec $volumepath/volume -m -n -t $statuscmd -u $statussig

Reload i3 configuration by pressing mod+Shift+r

Usage

Use your keyboard volume keys to increase, decrease, or mute your volume. If you have a volume indicator in your status line it will be updated to reflect the volume change (requires -t $statuscmd and -u $statussig to be set). When notifications are enabled (-n flag) a popup will display the volume level.

License

i3-volume is released under GNU General Public License v2