dactyl-manuform/README.md
2016-08-16 14:48:20 -04:00

41 lines
1.7 KiB
Markdown

# The Dactyl Keyboard
The Dactyl is a parameterized, split-hand, concave, columnar, ergonomic keyboard.
<img src="https://raw.githubusercontent.com/adereth/dactyl-cave/master/resources/glamourshot.png"/>
## Assembly
### Generating a Design
**Setting up the Clojure environment**
* (Download and install the Clojure runtime)[https://clojure.org]
* (Download and install the Leiningen project manager)[http://leiningen.org/]
* (Download and install OpenSCAD)[http://www.openscad.org/]
**Generating the design**
* Run `lein repl`
* Load the file `(load-file "src/dactyl_keyboard/dactyl.clj")`
* This will regenerate the `things/*.scad` files
* Use OpenSCAD to open a `.scad` file.
* Make changes to design, repeat `load-file`, OpenSCAD will watch for changes and rerender.
* When done, use OpenSCAD to export STL files
**Tips**
* Some other ways to evaluate the clojure design file - http://stackoverflow.com/a/28213489
* Example designing with clojure http://adereth.github.io/blog/2014/04/09/3d-printing-with-clojure/
### Printing
Pregenerated STL files are available in the [things/](things/) directory.
### Wiring
Masks for the flexible PCBs I used are available for the [left](resources/pcb-left.svg) and [right](resources/pcb-right.svg) side.
A [very rough guide for the brave is here](guide/README.md) - It will be improved over time (**TODO**)!
## License
Copyright © 2015 Matthew Adereth
The source code for generating the models (everything excluding the [things/](things/) and [resources/](resources/) directories is distributed under the [GNU AFFERO GENERAL PUBLIC LICENSE Version 3](LICENSE). The generated models and PCB designs are distributed under the [Creative Commons Attribution-NonCommercial-ShareAlike License Version 3.0](LICENSE-models).