MagicWand makes your input devices context sensitive
MIT License
MagicWand makes your input devices context sensitive!
It lets you define application-specific keyboard shortcuts and mouse events to trigger actions like keystroke emulation, command execution or even DBus method calls.
This means you can make your horizontal wheel behave differently for different applications: make it switch tabs when your browser is focused, but control the volume when your music player is active.
Note: MagicWand currently only works on Linux with evdev and Xorg!
Make sure you have a working Go environment (Go 1.7 or higher is required). See the install instructions.
To install MagicWand, simply run:
go get github.com/muesli/magicwand
Edit the config file and adjust it to your needs. First things first, tell MagicWand which input devices to operate on. You can either match them by their name or directly specify an input device file. For example:
"devices": [
{
"name": "MX Master"
},
{
"dev": "/dev/input/event6"
}
]
This will match two devices and makes MagicWand react to input events from:
/dev/input/event6
Next tell MagicWand which events to react upon:
"rules": [
{
"application": "Firefox",
"hwheel": 1,
"action": {
"keycode": "42-29-15"
}
}
]
In plain english, this means: if the currently focused application is Firefox
and you scroll left
with the horizontal mouse wheel, emulate a keyboard stroke
Ctrl-Shift-Left
(keycodes 42, 29 and 15): this makes Firefox jump to the
previous tab.
If you have multiple devices emitting certain events, you can configure which device a rule applies to:
"rules": [
{
"device": {
"name": "MX Master"
},
"hwheel": 1,
"action": {
...
}
}
]
Another example would be defining global shortcuts for certain mouse buttons:
{
"application": "!Firefox",
"keycode": "276",
"action": {
...
}
}
This translates to: if the currently focused application is anything but
Firefox
and the forward
mouse button was pressed (keycode 276), trigger
an action.
Actions can not only be keystrokes (as in the example above), but you can also use them to execute a command:
"action": {
"exec": "pactl set-sink-volume 0 +5%"
}
Last but not least, actions let you call DBus methods:
"action": {
"dbus": {
"object": "org.kde.KWin",
"path": "/KWin",
"method": "org.kde.KWin.previousDesktop"
}
}
Once you're done, start MagicWand:
$ magicwand
There are config examples for a few devices in the configs
directory. You can
try them out by starting magicwand
with the -config
argument:
$ magicwand -config ./configs/logitech_mxmaster.json
MagicWand uses uinput
to emulate keyboard events. Make sure your user has the
correct permissions to access /dev/uinput
:
echo KERNEL==\"uinput\", GROUP=\"$USER\", MODE:=\"0660\" | sudo tee /etc/udev/rules.d/99-magicwand.rules
sudo udevadm trigger