45 lines
1.9 KiB
Markdown
45 lines
1.9 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"/>
|
|
|
|
There's a talk about the motivation and design of the Dactyl that helps provide context for this repo:
|
|
|
|
[](https://www.youtube.com/watch?v=uk3A41U0iO4)
|
|
|
|
## Assembly
|
|
|
|
### Generating a Design
|
|
|
|
**Setting up the Clojure environment**
|
|
* [Install the Clojure runtime](https://clojure.org)
|
|
* [Install the Leiningen project manager](http://leiningen.org/)
|
|
* [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.org#wiring) - 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-ShareAlike License Version 4.0](LICENSE-models).
|