geekhack

geekhack Community => geekhack Media => Topic started by: zlobin356 on Thu, 21 May 2026, 14:28:52

Title: [KMAC] KMAC Programming Tool
Post by: zlobin356 on Thu, 21 May 2026, 14:28:52
hello geekhack~! long time no see

So, recently i became an owner of KMAC 1.2, fantastic keyboard, but it haves a small issue - i cant programm the OG pcb
Surely, there are Mechlovin replacement pcbs, but i wanted to keep it as OG Built as possible, as it was in 2013.

(https://imgur.com/8yGOwXf.jpg)

Ive been digging for kmac software for a long time, but i couldnt find anything, both in google/kbdmania/otd.kr, and locally in DMs
decided to ask my friend Damonskv for any leads, since he owns few KMACs, and after small portion of time he found the OG programming guide and all needed files for it!

(https://i.imgur.com/oklWEGx.jpeg)

:thumb: So, lets not waste our time and started flashing and programming :thumb:

Step 1: Download all needed tools
First of all, we need our KMAC Tools, i left them in attachments in ZIP-File, and of course we need QMK Toolbox.
Old guide suggested Atmel FLIP software, but its heavily outdated and doesnt work properly anymore.
Dont worry, QMK will work anyways. i of course tested everything on my keyboard, but i still dont hold any responsibility for your PCB!

(https://i.imgur.com/YVQW9yo.png)
(https://i.imgur.com/RGNd6SJ.png)

Step 2: Prepare everything
So, lets unpack all content from ZIP file, and open it up.
We need file called "kmacs.exe", once we start it up we will see such menu
(https://i.imgur.com/CdpiFrO.png)
What we want to do next is to choose keyboard we want to programm and reflash, i only have support XML files for KMAC TKLs, KMAC Mini and KMAC PAD.
(if you would have any leads towards KMAC Happy software - let me know here or in discord (zlooobin)
IM NOT SURE ABOUT PCB REVISIONS OLDER THAN 1.4! WILL YOUR KMAC 1 OR KMAC LE WORK - I DONT KNOW (but i think they would haha :thumb:)
list of 100% supported keyboards:
KMAC 1.2
KMAC 2
KMAC 2 CE
KMAC MINI
KMAC PAD


So, in top left we can see this panel with kbd names, we choose the one we need.
(https://i.imgur.com/ioYUWFB.png)
For example, i will go with KMAC TKL, process for other keyboards is same, just choose the one you need :thumb:

So, now we click "Import" and choose .XML keymap file of keyboard we need from same directory as programm
(https://i.imgur.com/5NZdupr.png)
(https://i.imgur.com/0rB6wSR.png)

Once we open it up, we have imported our .XML into programm, and we should see something with this
(https://i.imgur.com/NK7Hjdj.png)
Now, make your desired layout or keep this one :thumb:

Once you done, you can click "Export" and name the file however you want (special symbols / spaces / original filename are not allowed)
(https://i.imgur.com/IYAgFUD.png)
Now you need a .HEX file, to actually flash your keyboard. To make it, click "Make HEX"
And now you have .HEX!
(https://i.imgur.com/pMGChBc.png)
(https://i.imgur.com/GJ8HqkM.png)
We have HEX now! Yay! lets flash the keyboard!

Before we open up QMK, lets prepare our keyboard for flashing.
First, we have to disconnect usb cable, this step is universal for all keyboards. Later we have to hold down Caps Lock (on KMAC TKL / KMAC MINI) or FN Toggle key on KMAC PAD

Once we done it, lets open up QMK and choose our MCU (its atmega32u4)

(https://i.imgur.com/C3svpXa.png)
Now click open, choose the .HEX file of your keyboard, connect it via USB and click flash! Should show up like this and work immediately
(https://i.imgur.com/UY9vSz5.png)
(https://i.imgur.com/HHxYX8B.png)

Hope this helped! Show-off your kmacs below!

shout out to:
damonskv
skystrobe
jcrouse
the pig