QMK_KeymapToAsciiTable is a python script, that automates boring and time consuming task of making ASCII table for your QMK powered keyboard. It gets input from keymap.c QMK format file, in it's directory, make a new file called comment.txt, that contains searched keylayers and of course ASCII table.
This script is based on basic Python, should work in every devices that has Python installed :O
-
put the script file in the same path where your keymap.c file is.
-
execute the script, it will generate file called
comment.txtandKeyboardLayout.json. -
If you are using plane Ortho-linear keyboard, You can just open
comment.txt, and copy the result. -
If you are not Ortho-linear keyboard user and wish to custommize keysizes you can do followings:
- Open the
KeyboardLayout.jsonfile that have been generated by first time you execute the script. - Type in you keyboard configurations, the keysizes. For example, If you 1st row's first key is 2u, you should fine a part startes with
"0" :and change the first Item to 2. Remeber that the first row / key is always 0 not 1. One thing to keep in mind: this script does not support decimals for theKeyboardLyout.json. You should only use integers in it. - Re-run the script, check the re generated
comment.txt.
- Open the
Basically, any layouts!
Are you considering to contribute and add helpful features? Thanks! All you have to do is:
Just like other repos, Fork it, and Pull request!
- BIG ASS ENTER support
- Custom layout support
- Find a better way to edit keyboard layout, not editing Json by hand
- Add decimal sized key(such as 1.5u) support
RionLion100 for inspirations!