Creating a working ergonomic keyboard. From files to physical. 2023-10-1
It all began with the lily58. An ergonomic keyboard that has 58 keys. I loved the design and layout. But it wasn't portable. It required a large amount of desk space to function comfortably with palm wrests and wires running everywhere to connect the two halves of the board and the board to the computer.
I began to browse around for other options. A portable, wireless, lily58 keyboard. Did such a thing even exist?
I found this post. Which lead me to the extremely well documented github project. But there was a huge problem. Where do I buy the keyboard? Where do I buy the parts?
There are none!
You need to fabricate and assemble this keyboard from the files on github.
Using KiCad (An open source cad program for linux) I opened, customized and finally, after much reading and tweaking, exported the cutter files. Cutter files are used by PCB manufacturers to produce PCBs. I uploaded the files to Elecrow, a manufacturer in China. Then waited patiently for the PCBs to arrive in the mail.
Once the PCBs showed up, I began soldering. In short order everything was built and ready to go. Except the firmware. There were example firmwares in the source repository but I wanted some specific layers, macros and the Dvorak layout. To get all these features I had to build them using the ZMK firmware.
Understanding the ZMK firmware was a challenge. The way you program the keyboard is by building out header files in c. The documentation is decent but understanding what its doing and how its happening is challenging. One easy part of the project is the brilliant usage of Github Actions by the ZMK developers. Every time a commit is made and pushed to github, it builds the firmware for you automatically. This saves a lot of hassle and makes building keyboard firmware a lot more accessible.
After much trial and error the keyboard was ready for action.
Example of zmk header for Dvorak layout
At first the blank keycaps were a cost saving measure. Keycaps without legends are considerably cheaper. But after some time using them, I have come to love them. Despite being able to touch type people generally still look at the keys frequently for numbers and symbols. Without any reference, you learn to touch type them as well. Ultimately it has made me a faster typist.
Used a large battery which I drew a mutant frog on the tape.
Same layout, different designs
Other Projects
Tired of showing the contents of your audio books library in your music app?
Creating a working ergonomic keyboard. From files to physical.
Trying to build your own keyboard? Here are some links!
How I created, encrypted note taking application, solid scribe.
If an image is being displayed on a website and for some reason that asset disappears, you can catch that error and display a placeholder image with a little inline js.
Sometimes you need to change the remote origin in a git repo, if the server moves or if you just get better at NGINX and change the URL to something cleaner. Here are the simple steps on how to update your remote origin.
This will walk you through installing a custom rom on your phone, updating the firmware and installing google apps. Then rooting your phone.
Designing and building of Ravenwulfconsulting.com
As we fumble around life, doing little projects we end up learning little things and forgetting a lot of things.
To kill all instances of an application us the command killall
Search text files in current directory and all sub directories. Its super fast so don't worry if you have a node_modules directory or something.
I was noticing high CPU usage for the pipewire process on Ubunutu.
Why would anyone in their right mind us vim? I asked myself this question 543 times in the last 3 years. To my own surprise, I found myself wanting to use vim. The justification being that you can write code without using a mouse.
Sunshine is a desktop streaming client for linux that offers efficient, low latency PC streaming, for free. Download Sunshine onto your linux machine (the host) Sunshine Github Download moonlight onto whatever device you streaming on (the client) Moonlight Homepage
At some point I became infatuated with the SAMA IM01 Case. At only 22 liters, it can house an ATX power supply and a large cooler. I bought two! Thus began the journey of rebuilding both my PC and my unRaid server into smaller cases.
A few highlights of my time programming
Running a bash script on system start can be an involved process, depending on you distro. The proper way is to create a system service and plug it into /init.d but you can leverage the crontab if you want a simple quick way to run something on startup.
Cloudflare has a partnership with MailChannels which has allowed Cloudflare to introduce email sending into its web workers. There is some documentation to set this up but its all over the place. Here are the steps I took to get email sending running, using workers.
You can setup nginx to point subdomains at specific ports.
Sleep Linux Mint with this keyboard shortcut
If your server has a .env file, it may be necessary to parse those variables into a bash script. This can be accomplished by using the 'source' command.
Ergonomic keyboards have a number of benefits.
There is a program called Howdy, which is like Windows Hello. It uses face data as authentication. Howdy Github Repository