How to Build a DIY QMK-Powered Macro Keypad

2022-05-28 10:22:49 By : Ms. Sarah Zheng

Improve your productivity and make your time at the computer smoother with your very own DIY macro pad.

Whether you’re a Twitch streamer, a 3D designer, or just about any other type of computer user, macro keypads (also known as macro pads or macro keyboards) can come in handy. Acting as an auxiliary keyboard, these small devices can be loaded with shortcuts, macros, and other keyboard commands to make it possible for you to handle complex actions with a single keypress.

Instead of buying a macro keypad, why not make one yourself? We’ll show you how to use mechanical keyboard switches, an Arduino, and QMK’s keyboard firmware to get started.

You’ll need some tools and parts for your macro keypad build. You should be able to get them all online.

Once you have all of your parts handy, it will be time to start your macro keypad build. This process can be fiddly and challenging, but it will also be satisfying once you get to the end of it. Let’s dive right into the work you need to do.

First, you need to print out the case and backplate for your macro keypad. We didn’t make the 3D models for this project; we found them on Thingiverse. The Stream Cheap Mini Macro Keyboard was originally built by DaveM, though we’ve modified the approach to the soldering and keyboard firmware to make it a little easier.

We used PLA for the base section of the keyboard and PETG for the backplate, but you can use any type of filament you like. Ours didn’t require supports, rafts, or any other additions. It can be worth experimenting with your print settings if you are new to 3D printing, and those using local printing shops will be able to get advice for their print settings.

If you print at home, it makes sense to use the time it takes to print your keypad to work on the other project elements.

Before you can start wiring anything up, you need to build a configuration for your keypad that will enable it to work properly. You’ll need to go to a couple of different websites for this. The first is Keyboard Layout Editor. You can use this site to create a keyboard layout like the one in the image above, then go to the Raw Data tab and copy the simple code found inside.

The next site you will need to visit is called Keyboard Firmware Builder. As its name suggests, this site allows you to create keyboard firmware that is powered by QMK, while also providing you with an easy way to figure out your Arduino pins. This part of the process takes a few different steps.

Keep a hold of this firmware, as you will need it later on. First, though, it’s time to wire up the Arduino and switches you’re using.

Wiring up your Arduino with your switches is a fairly simple process. We started by cutting out lengths of wire in two colors. You need two wires for your rows and four wires for your columns, and we used red and black respectively.

Next, it’s time to start soldering wires to the legs on your switches. Make sure that your switches are in the right positions clipped onto the backplate before you start this. As the switches need to attach to the wire at different points, we find that it is best to cut sections out of the wire insulation, as seen in the image above.

We started by soldering the wires for our rows to the right leg of each switch, followed by the wires for our columns in the left legs. See the image above for an idea of what this looks like when it is done.

Next up, it will be time to solder the wires you’ve just installed onto the Arduino board you’re using. This process should be easy, as we’ve already figured out where each wire needs to be attached. The photo above shows how this should look when you’re finished. Just six wires, so nice and simple.

Related: The 9 Best Soldering Irons for Beginners

Before you go any further with the build of the keypad, it’s time to load the firmware you made earlier onto your Arduino to make sure that everything works properly. You will need to download a piece of software called QMK Toolbox from GitHub to go through this process, and the installer you want can be found in the Releases section of the project.

With QMK Toolbox installed, you can plug your Arduino into your PC using a micro USB cable. This should make the board flash, and your OS may give you a notification to tell you that a device has been plugged in.

Now you can load QMK Toolbox. Select Open next to the top bar, and choose the .HEX file you downloaded earlier. Before you can install this file on your Arduino, you need to put your board into its Bootloader mode. This can be achieved by shorting the Reset and Ground pins. We used a small piece of wire to do the job.

Once the board is in the right mode, you only have a few seconds to hit the Flash button in the QMK Toolbox software. If you are successful, your screen should look like the one above, but you can always try again if you don’t manage to flash to board in time.

Testing is important whenever you work with an Arduino, as you can often save a lot of time if you identify issues early on. We used a website called Keyboard Checker to test our work. This site tells you the last key that was pressed, even if not included in the graphic; perfect for a keyboard using higher F keys. Just make sure all of your keys work before going forward.

It’s finally time to assemble your keyboard. Start by attaching the Arduino to the inside of the case. You can use double-sided tape for this, but we opted for superglue to get the best possible hold. You must make sure that you position your Arduino so that your USB cable can insert fully into the device.

Next, it’s time to attach the backplate to the main keyboard body. If you’ve used PLA for your print, you will be able to simply screw your M3 bolts into the holes at each side of the backplate. For harder materials, though, you may need to use a tap to create a thread. Make sure that each key works properly once you have tightened the bolts.

Finally, you can add your keycaps to the top of your keyboard and start using it.

Most software will allow you to change the default keybindings found within, which should make it easy to use your macro keyboard for a host of different applications. You could also consider the idea of building firmware with more complexity. The website we used earlier enables you to add layers, macros, and even lighting to your keyboard.

Whether you feel adventurous or not, we hope that you enjoy the macro keyboard you make. This project is great fun, while also offering a way to learn about soldering and keyboard building.

Samuel is a UK-based technology writer with a passion for all things DIY. Having started businesses in the fields of web development and 3D printing, along with working as a writer for many years, Samuel offers a unique insight into the world of technology. Focusing mainly on DIY tech projects, he loves nothing more than sharing fun and exciting ideas that you can try at home. Outside of work, Samuel can usually be found cycling, playing PC video games, or desperately attempting to communicate with his pet crab.

Join our newsletter for tech tips, reviews, free ebooks, and exclusive deals!