Ergonomic Keyboard Generator
The project aims to provide a common configuration format to describe ergonomic 2D layouts and generate automatic plates, cases, as well as 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.
Until there's a proper "Getting started" guide, try getting acquainted with Ergogen by following these steps in order:
-
Read the Documentation.
D'uuh. They're not complete by any measure, but should give you a fairly good idea what you're dealing with here.
-
Try one of the web-based deployments.
(The difference being that Stable runs the latest official release, while Nightly offers early access to in-progress features, both for the Ergogen engine and the UI.)
Load example configs, click things, rewrite things, look at outputs and see if things start to make sense.
There is no need for you to download the CLI unless you want to do one of the following:
- Preview in-development features
- Use custom modifications
- Contribute code
-
Search the
ergogentopic on GitHub.There, you can look at (and reverse engineer) a variety of real life configs using Ergogen. Pop them into the web UI to see what they do, tinker with them and things should start to make more sense.
-
If a question persists after all of the above, feel free to ask it over on Discord and we'll do our best to help you out.
Feature ideas, documentation improvements, examples, tests, or pull requests welcome! Get in touch on our Discord, and we can definitely find something you can help with, if you'd like to.
From an administrative standpoint, please note that we'd like to keep the Git history linear and the test suite comprehensive, so if you do issue a PR, make sure it's A) a straight chain of commits, B) it's always rebased on the current develop, and C) the test coverage remains at 100%.
Huge thanks go to everyone who chooses to support my work! But even huger thanks are due to the following, distinguished sponsors: