weston-binder

=============

This is a module for weston (makes sense with the desktop shell) for parsing

keybindings from weston.ini.

Building

--------

The build system is a simple one. To create the weston module, binder.so:

make

To install it:

make install

Usage

-----

To use this module, add its binder.so to the modules option:

[core]

modules=binder.so

For each key you want bound, append a similar keybind option to your

weston.ini:

[keybind]

key=ctrl+alt+t

exec=weston-terminal

Note that the key is bound before everything in the [keyboard] section is

applied, so if your logical layout is different from your physical one, your

configuration is going to be going to have to reflect your unaltered physical

keyboard layout (e.g. in Dvorak use `ctrl+alt+k` for the above example).

The `exec` string is fed to `sh -c {}`, so you can also put more complicated

lines in:

[keybind]

key=alt+f6

exec=sudo sh -c 'echo 900 > /sys/class/backlight/intel_backlight/brightness'

Using parentheses around the command seems to be necessary if the command

starts with an environment variable.

The case insensitive `key` parameter should be simple enough to get right. Join

different modifiers and keys with a plus sign. If you get it wrong, the module

reflects on your failure in weston logs.

To find the names of obscure keys, see linux/input-event-codes.h (probably in

/usr/include/). The "KEY_" prefix must be omitted in the configuration file.

There's a total of 3 modifiers you can have: ctrl, alt and super.

Examples

--------

Here's a few useful examples:

# PulseAudio sound controls

[keybind]

key=mute

exec=pamixer -t

[keybind]

key=volumeup

exec=pamixer -i 10

[keybind]

key=volumedown

exec=pamixer -d 10

# Music Player Daemon controls

[keybind]

key=alt+8

exec=mpc prev

[keybind]

key=alt+9

exec=mpc next

[keybind]

key=alt+0

exec=mpc toggle