This is about these kind of mass produced macro keyboards
This is third party software that has wide support for a variety of macro keyboards produced in great numbers in China. It’s the only way to program these under Linux.
https://github.com/kriomant/ch57x-keyboard-tool
Great tool, poor documentation. I’m running Ubuntu 22.04.3 LTS (Jammy Jellyfish)
Rename the executable file to something shorter like ch57x
Make a copy of the example config file before editing. I edited 3key.yaml below.
Open the terminal inside the folder where you’ve unzipped the file
When using the linux version under Ubuntu the formatting for commands is
./ch57x --help
To do anything with elevated permissions use sudo
sudo ./ch57x led 1
To validate the configuration file, read the directions in the example file very, very carefully.
Validation requires elevated permissions
sudo ./ch57x validate < 3key.yaml
Once you get the OK from the validation tool, writing the config file also requires elevated permissions
sudo ./ch57x upload < 3key.yaml
Here’s the output of ./ch57x --help
Commands:
show-keys Show supported keys and modifiers
validate Validate key mappings config on stdin
upload Upload key mappings from stdin to device
led Select LED backlight mode
help Print this message or the help of the given subcommand(s)
Options:
--vendor-id [default: 4489]
--product-id [default: 34960]
--address
-h, --help Print help information
