evdev-shortcut 0.1.5

Global shortcuts using evdev
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

# evdev-shortcut

Global shortcuts using evdev

## Why

Because evdev exists at a level above the display server, evdev shortcuts will
work with both X11, wayland, or headless/cli systems.

## Usage

```rust
use std::path::PathBuf;
use glob::GlobError;
use evdev_shortcut::{ShortcutListener, Shortcut, Modifier, Key};
use tokio::pin;
use futures::stream::StreamExt;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    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);
    }
    Ok(())
}
```

Note that raw access to evdev devices is a privileged operation and usually
requires running with elevated privileges. See
[shortcutd](https://codeberg.org/icewind/shortcutd) for a solution to running
the elevated input handling in a separate process.