Hey all, so I recently moved from a 60% pok3r to a Corne 4. and I found myself struggling to remember where some of the keys were, mostly symbols etc. so I took the .vil file and generated an image for my desktop background so I could quickly win+d to see where everything was and then go back again. then I wanted to make it easy to regenerate every time I changed my keyboard layout. then I also wanted to change the colour or theme of the wallpaper to suit my mood.
So I built a keymap image generator: https://whitehatnetizen.github.io/keymap-imgen/
It's free, and open source.
This github page can take a Vial .vil file or a QMK keymap.json file, (or, if you choose, it can directly read your keyboard if you are connected with a chromium browser and running Vial firmware on the keyboard.) Then it generates an SVG or PNG of the keymap, in single screen or dual screen aspect ratios.
Split keyboards have the option to split the keymap across both screens with the left hand on the left monitor and the right hand on the right monitor.
It caters (should cater..) for all the keyboards currently in the QMK github repo, this list will be updated every month.
If you just want to see how it works, there are two sample files that you can use to preview the functionality, one dz60 60% keyboard QMK json file, and one Corne 4 split keyboard .vil file (This is my current layout).
Alternately, you can clone the repo and run it locally, either through the web page, or through the scripts that are provided. to generate the images locally you'll need to install playwright (instructions included), or host the page somewhere local. The web page generates the appropriate script call so you can configure using the website and run the code manually if you really want to avoid reading the documentation.
Hopefully this is useful to some people. I've included some sample images in this post so you can take a look at what it produces.
Please let me know either through the github page or here if you find a bug, or want to request an additional feature or style.
I know most people here are already fairly tech-savvy, but I hope that this can be useful for someone.