1
0
Ergonomic keyboard layout generator
Go to file
2021-07-17 01:15:27 +02:00
docs Doc update and bump for 2.0.0 release 2021-03-15 16:17:58 +01:00
meta Add JSON schema 2020-10-05 22:12:13 +02:00
src Improved interface testing 2021-07-16 20:18:09 +02:00
test End-to-end CLI tests 2021-07-17 01:15:27 +02:00
.gitignore Bundling and release prep 2020-09-27 15:11:22 +02:00
license.md Docs cleanup 2020-10-18 13:41:06 +02:00
package-lock.json End-to-end CLI tests 2021-07-17 01:15:27 +02:00
package.json End-to-end CLI tests 2021-07-17 01:15:27 +02:00
readme.md docs(readme): fix typo in web ui url link 2020-11-03 15:10:35 +01:00
rollup.config.js Improved interface testing 2021-07-16 20:18:09 +02:00

Ergogen

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.

Usage

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.

Contributions

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.