https://github.com/srwi/qmk-via-api
VIA api implementation for QMK-based keyboards
https://github.com/srwi/qmk-via-api
keyboard-firmware python qmk rust via
Last synced: 5 months ago
JSON representation
VIA api implementation for QMK-based keyboards
- Host: GitHub
- URL: https://github.com/srwi/qmk-via-api
- Owner: srwi
- License: gpl-3.0
- Created: 2024-02-01T21:30:27.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-03-22T19:53:02.000Z (7 months ago)
- Last Synced: 2025-05-05T05:08:26.519Z (5 months ago)
- Topics: keyboard-firmware, python, qmk, rust, via
- Language: Rust
- Homepage:
- Size: 88.9 KB
- Stars: 20
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# qmk-via-api
[](https://crates.io/crates/qmk-via-api)
[](https://pypi.python.org/pypi/qmk-via-api)
[](https://pypi.python.org/pypi/qmk-via-api)
`qmk-via-api` provides an implementation of the [VIA](https://www.caniusevia.com/docs/specification) API for [QMK](https://github.com/qmk/qmk_firmware) (Quantum Mechanical Keyboard) based keyboards. It allows developers to interact with QMK keyboards programmatically, enabling tasks such as configuring keymaps, macros, lighting effects and more.
Additionally, this library includes Python bindings for all API calls for integration of QMK keyboard configuration into Python-based applications or scripts.
# Usage
## Rust
Add dependency with Cargo:
```bash
cargo add qmk-via-api
```
Usage example:
```rust
use qmk_via_api::api::KeyboardApi;
const PRODUCT_VID: u16 = 0x594D;
const PRODUCT_PID: u16 = 0x604D;
const USAGE_PAGE: u16 = 0xff60;
fn main() {
let api = KeyboardApi::new(PRODUCT_VID, PRODUCT_PID, USAGE_PAGE).unwrap();
println!("Protocol version: {:?}", api.get_protocol_version());
println!("Layer count: {:?}", api.get_layer_count());
}
```
## Python
Install with pip:
```bash
pip install qmk-via-api
```
Usage example:
```python
import qmk_via_api
PRODUCT_VID = 0x594D
PRODUCT_PID = 0x604D
USAGE_PAGE = 0xff60
if __name__ == "__main__":
api = qmk_via_api.KeyboardApi(PRODUCT_VID, PRODUCT_PID, USAGE_PAGE)
print(f"Protocol version {api.get_protocol_version()}")
print(f"Layers count: {api.get_layer_count()}")
```
# License & Attribution
Parts of this project are based on code from [the VIA project](https://github.com/the-via/app), which is licensed under the GNU General Public License v3.0.