We made a simple tool that you can use to flash your keyboard directly from the terminal. It's called Zapp, it is available for Windows, macOS, and Linux, and it looks like this:
Zapp has three sub-commands:
- Flash: Accepts a local firmware file or an Oryx URL and uses it to flash your keyboard.
- Update: Automatically checks if your keyboard is running the latest version of your layout, and flashes if necessary.
- Help: Explains these two commands.
How Update works
Fun fact: If you use Oryx to compile your firmware, your layout ID and revision ID are saved on your keyboard. That's how Zapp can find your layout and figure out if you're running the latest version. No login needed, no credentials to save on your machine, etc.
Agent-friendly
Zapp is simple and self-documenting. If you told Claude Code it's installed and asked it to run it and learn how to use it, you could tell Claude things like "Flash my Voyager" and it probably will. You still have to press the keyboard's physical Reset button, though.
Open source
Zapp is free, and it is also fully open source. It's written in Rust. Feel free to dive through the code and see how it works, audit it for security issues, etc. If you find anything that could be improved, send us a pull request.
Enjoy!
As always, thank you for reading, and I'd love to hear what you end up doing with Zapp. Email me and the team anytime.
