Atreyu keyboard Build

Creating a working ergonomic keyboard. From files to physical. 2023-10-1

atreyu complete

It started with an existing keyboard

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?

lilly banner

Finding the right project

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.

Exporting the cutter files and fabrication

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.

Building and programming

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.

zmk config example Example of zmk header for Dvorak layout

Blank Keycaps

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.

My first build with the Atreyu PCB

Used a large battery which I drew a mutant frog on the tape. another atreyu

First build and second build

atreyu no capsatreyu various switches

Atreyu Compared to lily58

Same layout, different designs comparison

Other Projects

Tell Android to ignore folder contents

Tired of showing the contents of your audio books library in your music app?

Atreyu keyboard Build

Creating a working ergonomic keyboard. From files to physical.

Build a Keyboard Links

Trying to build your own keyboard? Here are some links!

Creation of Solid Scribe

How I created, encrypted note taking application, solid scribe.

Catch missing image assets inside image tag

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.

Change remote origin in git repo

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.

crDroid 9.1 OnePlus 7 pro install/update

This will walk you through installing a custom rom on your phone, updating the firmware and installing google apps. Then rooting your phone.

Creation of Ravenwulf Consulting

Designing and building of

Obligatory I am starting a blog, blog post

As we fumble around life, doing little projects we end up learning little things and forgetting a lot of things.

Killing programs in mac or linux

To kill all instances of an application us the command killall

Linux Search text in this and all sub directories

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.

Lower Pipewire CPU usage on Ubuntu while using Firefox

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 a Parsec Alternative for Linux, GeForce Now alternative for Windows

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

PC Builds

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.

Proudest Software Engineering Achievements

A few highlights of my time programming

Run bash script on linux start

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.

Sending Emails with Cloudflare Workers

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.

Setup nginx to point subdomain at port

You can setup nginx to point subdomains at specific ports.

Sleep Linux Mint Keyboard Shortcut

Sleep Linux Mint with this keyboard shortcut

Get .env file variables into bash scripts

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.

Why use ergonomic keyboards?

Ergonomic keyboards have a number of benefits.

Windows Hello for Linux

There is a program called Howdy, which is like Windows Hello. It uses face data as authentication. Howdy Github Repository

Max Gialanella - 2024