Firmware Customization

Customizing the Technikable keymap/firmware.

Overview

Although ZMK does not yet have GUI keymap update software, updating the keymap can be done without installing any local build tools or toolchain. This step will walk you through setting up your personal keymap/configuration.

Prerequisites

An understanding of the high level ZMK keymaps is helpful in preparing to customize your Technikable keymap.

To have your new Technikable firmware built automatically for you, you will need to create a GitHub accountt to manage your personal repo.

ZMK Config Repo

After logging into your GitHub account, open https://github.com/petejohanson/technikable-zmk-config in your browser. In the top right corner, there is a button labeled "Fork":

Fork Button

Once the fork is prepared, you should be presented with a list of files in your repository:

Repo Listing

Clicking the boards/arm/technikable/ link brings you to the full listing of files for the Technikable:

Board Directory

The technikable.keymap file contains your keymap:

View Keymap

Enabling GitHub Actions

Before making further changes, click the "Actions" link in your fork. When presented with the option, click "I understand my workflows, go ahead and run them" button.

Keymap Editing

From the keymap file page, clicking the small pencil icon will bring you to the web editor and let you make changes to your keymap:

Edit Keymap

Once happy with your changes, enter a commit message describing them and click the commit button:

Commit Changes

Download & Install

After committing the changes click the "Actions" link along the top to see the list of GitHub Actions builds. Find the new build in the listing, and click on the description:

Latest Build

From there, near the bottom of the screen will be download labeled "firmware", that you should click to download:

Firmware Download Link

Once downloaded, unzip the downloaded file, and you will have a file, named technikable.uf2.

Connect your Technikable to your computer using a USB cable, and double tap the reset button through the small hole on the bottom of the case. The blue LED should flash, slowing down once detected and connected to your computer.

A new USB "drive" should appear on your connected computer, with a name of "TECHNIKABLE". Copy and paste the technikable.uf2 images to the new USB drive, and Technikable should complete flashing the new image and instant restart into it.