SNDIOKEYS(1)

NAME
sndiokeys - control sndiod with hot-keys and play the keyboard bell

SYNOPSIS
sndiokeys [-aDsv] [-b [mod+...]key:control[+|-|!]] [-f device]

DESCRIPTION
sndiokeys registers hot-keys in X(7) to control sndiod(8). It can also replace the X(7) keyboard bell by a beep on the audio device.

The default key-bindings are as follows:

Control+Mod1+plus
    increase output.level
Control+Mod1+minus
    decrease output.level
Control+Mod1+M
    toggle output.mute
Control+Mod1+0
    cycle through server.device

sndiokeys is meant to be started as a background process by startx(1) or the display manager session startup scripts. It exits when the X session terminates.

The options are as follows:

-a  Play an beep on the audio device in place of the X(7) keyboard bell.

-b [modifier+...]key:control[+|-|!]
    Increase, decrease or toggle control whenever key is pressed while modifier keys are held down. Key names correspond to symbols defined in /usr/X11R6/include/X11/keysymdef.h with the XK_ prefix removed. Supported modifiers are: Control, Mod1, and Mod4. On most setups, Mod1 and Mod4 correspond to the Alt and Windows keys. Available controls may be listed with the sndioctl(1) utility.

-D  Daemonize.

-f device
    Audio device to control.

-s  Don't emit a beep when a control changes.

-v  Increase log verbosity.

EXAMPLES
Increase or decrease the output level when Up or Down keys are pressed while the Control and Mod1 keys are held down:

    $ sndiokeys -b Control+Mod1+Up:output.level+ \
                -b Control+Mod1+Down:output.level-

Make volume keys found on multimedia keyboards control the output level:

    $ sndiokeys -b XF86_AudioRaiseVolume:output.level+ \
                -b XF86_AudioLowerVolume:output.level- \
                -b XF86_AudioMute:output.mute!

SEE ALSO
sndioctl(1), startx(1), sndio(7), X(7), sndiod(8)

BUGS
The volume keys of multimedia keyboards may already control the output level using another mechanism. If so, using the same keys in sndiokeys may cause unpredictable output level changes.