SNDIOKEYS(1)

NAME
sndiokeys - control sndiod with hot-keys and play keyboard bells

SYNOPSIS
sndiokeys [-a] [-b [mod+...]key:func] [-D] [-s] [-v] [-f device]

DESCRIPTION
sndiokeys registers hot-keys in X(7) to control sndiod(8). It can be used to replace the X(7) keyboard bells by audible beeps 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+0
    cycle through audio devices.

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

The options are as follows:

-a  Play audible beeps on the audio device in place of the X(7) keyboard bells.

-b [modifier+...]key:function
    Perform function 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. Function names are:

    inc_level
        increase output level
    dec_level
        decrease output level
    cycle_dev
        cycle through audio devices

-D  Daemonize.

-f device
    Audio device to control.

-s  Don't emit audible beep when output level or audio device are changed.

-v  Increase log verbosity.

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

    $ sndiokeys -b Control+Mod1+Up:inc_level \
                -b Control+Mod1+Down:dec_level

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

    $ sndiokeys -b XF86_AudioRaiseVolume:inc_level \
                -b XF86_AudioLowerVolume:dec_level

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

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