Ergogen is a keyboard generator that aims to provide a common configuration format to describe ergonomic 2D layouts, and generate automatic plates, cases, and (un-routed) PCBs for them. The project grew out of (and is an integral part of) the Absolem keyboard, and shares its Discord server as well.

Supposing you have a config ready, you can use ergogen either on the command line, or through the web UI.

Command line usage requires node v14.4.0+ with npm v6.14.5+ to be installed, the repo to be checked out, npm install to be issued, and then simply calling the CLI interface through node src/cli.js. The --help switch lists the available command line options.

The web UI is a more accessible version of the same codebase, where everything happens in your browser. It's been patched together on a fresh Chrome-derivative, and I didn't take any care to make it compatible with older stuff, so please use something modern!

As for how to prepare a valid config, please read the reference, or browse the docs folder for additional examples.

Feature ideas, documentation improvements, examples, tests, or pull requests welcome! Get in touch on Discord, and we can definitely find something you can help with, if you'd like to.