A simple CLI for bidirectional communication with QMK keyboards using raw HID, written in Rust with a small memory footprint.
You can install qmk-hid using Cargo or by building it from source.
cargo install qmk-hidTo use qmk-hid you must find you keyboard's vendor ID and product ID. They can be usually found in your keyboard's info.json or by using tools like lsusb.
On Linux, you have to setup udev rules to allow access to the HID device.
qmk-hid --help # prints help
qmk-hid --vendor-id 18003 --product-id 4 # example using a corve v4 keyboard
qmk-hid -v 18003 -p 4 # shorthandOnce qmk-hid is running:
- Incoming HID messages from the keyboard will be printed to standard output.
- Messages can be sent to the keyboard by writing to standard input.
- Errors and connection issues are reported to standard error output.
- If the keyboard is not connected,
qmk-hidwill continuously poll for a connection until the device is available (the default interval is 3000ms).
Important
In both directions the message length should be 32 bytes or less, you have to implement a custom protocol overwise
Since qmk-hid uses standard input and output for communication, it can be easily integrated into scripts or other programs. You can check out the NodeJS demo for a simple example.
To build qmk-hid you will need the Rust toolchain and libhidapi system libraries. Then you can just clone the repository and use the following command:
cargo build --releaseMIT