Crate evdev_shortcut

Global keyboard shortcuts using evdev.

By connecting to the input devices directly with evdev the shortcuts can work regardless of the environment, they will work under X11, wayland and in the terminal.

This does come at the cost of having to run the program with elevated permissions. See shortcutd for a solution to running the elevated input handling in a separate process.

Example:

let listener = ShortcutListener::new();
listener.add(Shortcut::new(&[Modifier::Meta], Key::KeyN));

let devices =
    glob::glob("/dev/input/by-id/*-kbd")?.collect::<Result<Vec<PathBuf>, GlobError>>()?;

let stream = listener.listen(&devices)?;
pin!(stream);

while let Some(event) = stream.next().await {
    println!("{} {}", event.shortcut, event.state);
}

Structs

• DeviceOpenError
  Error emitted when an input device can’t be opened
• ModifierList
  Set of modifier keys for shortcuts
• Shortcut
  A keyboard shortcut consisting of zero or more modifier keys and a non-modifier key
• ShortcutEvent
  Event emitted when a shortcut is pressed or released.
• ShortcutListener
  A listener for shortcut events

Enums

• Key
  evdev keycode
• Modifier
  Modifier key for shortcuts
• ShortcutState
  Whether the shortcut was pressed or released