Volume control with notifications, and a volume statusline indicator. Written for use with i3wm, but works with any window manager or as a standalone script.
Read our installation instructions for general usage with i3wm.
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. When notifications are enabled a popup will display the volume level.
| notify-osd | dunst | xob |
|---|---|---|
 |
 |
 |
| XOSD | herbe | volnoti |
|---|---|---|
 |
 |
 |
| KOSD |
|---|
 |
Read about notifications for more information.
i3-volume does not require any particular desktop environment and can be used as a standalone script.
Usage: ./volume [<options>] <command> [<args>]
Control volume and related notifications.
Commands:
up <value> increase volume
down <value> decrease volume
set <value> set volume
mute toggle mute
listen listen for changes to a PulseAudio sink
output <format> output volume in a supported format
custom format substitutions:
%v = volume
example: "My current volume is %v"
outputs show available output formats
notifications show available notification methods
help display help
Options:
-a use amixer
-n enable notifications
-t <process_name> process name of status bar (requires -u)
-u <signal> signal to update status bar (requires -t)
-x <value> maximum volume
-X <value> maximum amplification; if supported (default: 2)
-h display help
amixer Options:
-c <card> card number to control
-m <mixer> set mixer (default: Master)
PulseAudio Options:
-s <sink> symbolic name of sink
Notification Options:
-N <method> notification method (default: libnotify)
-p enable progress bar
-e <expires> expiration time of notifications in ms
-l use fullcolor instead of symbolic icons
-S <suffix> append suffix to symbolic icon names
-y use dunstify (default: notify-send)
Listen mode (listen comand) causes i3-volume to listen for changes on your PulseAudio sink. When configured, these events will update your status bar and dispatch on-screen display notifications to reflect the change.
Version 3 introduces commands which makes it incompatible with previous versions. Your command-line usage and/or configured hotkeys need to be updated to reflect this.
| Change | v2 | v3 |
|---|---|---|
-d is now the down command |
volume -d 5 |
volume down 5 |
-i is now the up command |
volume -i 5 |
volume up 5 |
-m is now the mute command |
volume -m |
volume mute |
-o is now the output command |
volume -o i3blocks |
volume output i3blocks |
-v is now the set command |
volume -v 5 |
volume set 5 |
-L is now the listen command |
volume -L |
volume listen |
-M is now the -m option |
volume -M Master |
volume -m Master |
i3-volume is capable of working with many other programs. The following lists a few with examples:
| Program | Note |
|---|---|
| i3blocks | See our example blocklet |
| xob | Requires extra steps for notifications. Guide |
| XOSD | Notifications require the -N xosd option. Example |
| herbe | Notifications require the -N herbe option. Example |
| volnoti | Notifications require the -N volnoti option. Example |
| KOSD | Notifications require the -N kosd option. Example |
| sxhkd | For keybindings with or without i3wm, often used with bspwm. Example |
Having a problem? Try reading our common issues or open an issue.
i3-volume is released under GNU General Public License v2
Copyright (C) 1989, 1991 Free Software Foundation, Inc.