Adam Welch’s FreeDeck is a tidier, more compact take on Kilian Gosewisch’s open-source visual macro-keypad concept. It keeps the defining feature—an OLED display that identifies what each physical key does—while adding custom through-hole and surface-mount PCB options and a 3D-printed enclosure. The result is a configurable, build-it-yourself alternative to a commercial macro pad, provided you match the case to the exact PCB revision.
What Adam Welch changed
Gosewisch’s FreeDeck concept uses several small OLED screens to show each key’s current function. Welch’s motivation was practical: “I’ve built a few different macro keyboards over the last couple of years, but the issue with [these] was that I can’t remember what I’ve assigned to each key.” His solution was a physical keypad that labels its controls visibly: “I love the idea of being able to display what each key is for.”
Welch adapted the original schematic into a custom, more compact PCB and a 3D-printed case. Hackster reports that the designs were added to the official FreeDeck GitHub repository under the GNU GPL-3.0 license. The project remains a DIY build rather than a finished retail product: you source the electronics, assemble the board, load the firmware and print or obtain a compatible enclosure.
Choose the PCB route before buying parts
The reported PCB designs are offered in two assembly styles. Pick the board first, because component packages and enclosure dimensions depend on that decision.
#1 Best Overall
- [Tri-Mode Connection] - Powerful 3-mode connection supports Wireless 2.4GHz + Bluetooth 5.0 + Wired USB-C. You can connect up to 3 bluetooth devices, 1 wireless 2.4GHz device and 1 wired device. Connect and switch devices easily. Press FN+1/2/3/4/5 switch to BT1/BT2/BT3/2.4G/Wired mode. Compatible with Windows, MacOS, IOS and Android systems. Support PC, laptop, Mac, smartphone, iPad and tablet.
- [Gasket-Mount & Hot Swap] - With gasket materials such as EVA foam and IXPE switch pads between the plate and housing on both top and bottom sides, the mechanical numpad kit provides a consistent, softer typing feel and pleasing acoustic feedback. The hotswap keypad diy base kit supports both 3 pin and 5 pin switches.
- [18 Keys Programmable & 19-Key NKRO] - Program all 18 keys except the FN key using the keypad driver. Customize each key with different functions such as system shortcuts, multimedia shortcuts, text input, one-click open for files/folders/web pages, macros, and more. This numpad custom kit features memory capability, ensuring settings are retained even after power loss. All 19 keys are anti-ghosting and non-conflict. Every keystroke is registered during intense gameplay and fast typing, no matter how many other keys are pressed at the same time. (Keypad Driver: bit.ly/K19-Driver)
- [True RGB Backlit & Multifunction Knob] - This RGB illuminated numeric keypad module has up to 18 backlight modes. Supports RGB colors and single color. You can also customize the backlight and turn on the music rhythm mode in the driver. Turn the metal knob to adjust volume, click the knob for Esc. FN+Click the knob to switch to brightness mode, then turn the knob to adjust the backlight brightness.
- [Rechargeable & Energy-Saving] - The numeric barebones keyboard has a 1500mAh lithium battery, with low-power chip and energy-saving technology, it can last between 30-60 days, depending on usage. Turn off the backlight automatically after 2 minutes of inaction. It goes to Hibernation Mode in 30 minutes of sitting idle to save battery, any key to wake up. Press FN+. to check the battery level.
| PCB option | Best fit | Trade-off |
|---|---|---|
| Through-hole | Builders who are new to soldering or prefer larger, easier-to-handle components | Less compact than the surface-mount version |
| Surface-mount | Builders prioritizing the smallest finished device | Requires more demanding surface-mount assembly |
Both versions are based on Gosewisch’s original circuit concept. The through-hole version is described as the easier entry point; the surface-mount design produces a more compact final assembly. Do not treat one as a later “pro” model: they are alternative construction routes with different soldering demands and physical results.
Documented prototype hardware
The hardware repository identifies a prototype built on perfboard. Hackaday’s build account describes the same core architecture. These parts document the prototype and should not be read as a guaranteed bill of materials for every PCB revision.
Rank #2
- DIY Fix your TV remote by cleaning the defective carbon keypad contact and copper switch pad
- Easy DIY electronics repair. Refurbish many household electronic gadgets ranging from sticky TV remotes, telephone keypads, game controls, automotive key fobs and more.
- USAGE TIP: For best product preparation, pour off and save liquid on top. Thoroughly mix paste on jar bottom, reintroduce top liquid and mix again.
- NOTE: An oil film on the repair surface may cause KeyPad-Fix to “bead up” and not stick to the contact that you are repairing. Clear away with an alcohol wipe and reapply.
- See below description for detailed usage information. Made in the USA.
| Part | Documented specification or role |
|---|---|
| Microcontroller | Arduino Pro Micro based on the ATmega32u4, 16 MHz, 5 V |
| Multiplexers | Two 4051 devices (also referred to as 74HC4051 in the build coverage) |
| Displays | Six SSD1306 OLED displays |
| Keys | Six 3 × 4 × 2 mm surface-mount tactile buttons |
| Storage | One SPI SD-card reader |
Before ordering, verify the package, voltage, pin arrangement and quantity against the files for your selected PCB. A part that is electrically similar may still be mechanically wrong for the footprint.
Build the keypad in a controlled sequence
- Select the board files. Decide between the through-hole and surface-mount design, then identify its stated revision and component footprints.
- Audit the parts. Confirm the Pro Micro variant, two 4051 multiplexers, six SSD1306-compatible displays, six tactile switches and the SPI SD-card reader match the board documentation.
- Assemble and inspect the PCB. Follow the repository’s construction instructions. Check solder joints, orientation marks and connector placement before applying power.
- Prepare the enclosure files. Use the case files associated with the same PCB revision, not whichever FreeDeck case is easiest to find.
- Install the electronics. Mount the controller, displays, buttons and SD-card hardware without stressing the display boards or trapping wires against the printed case.
- Load firmware and configure keys. The repository provides firmware and a configurator. Set each key’s action and its visible label, then verify that the display assigned to each physical button is the intended one.
- Test before final closure. Check every button, every OLED, SD-card access and USB connection while the case can still be opened.
The repository also links a walkthrough/tutorial video and construction documentation, which are useful when the wiring or display orientation is unclear.
Rank #3
- RGB Backlit: This 3 key keypad adopts RGB backlit that creates more gaming ambience for better gaming experience.
- Programmable Design: This macro keypad features programmable design that the key function can be set as your wish.
- USB Interface: This 3 key macropad adopts USB interface, and it supports plug and play, providing great convenience.
- Ergonomic Design: This macro pad also features ergonomic design, mini and lightweight, easy to carry.
- Material: This programmable keypad is made from premium ABS material, which ensures long service life.
Case fit depends on the PCB revision
This is the project’s most important mechanical warning. The repository states that revisions 1.1, 1.2 and 1.3 changed dimensions, while many cases shared online were made for revision 1.0. It points builders to newer cases in the wiki.
- Read the revision printed in the board files or documentation.
- Download enclosure files that explicitly name that revision.
- Compare mounting holes, outer dimensions, display openings and connector cut-outs before printing.
- Do a dry fit before committing to a long print or permanently closing the case.
A revision-1.0 case can look correct in a preview and still fail to accept a later board. Treat enclosure selection as part of PCB selection, not as a final cosmetic step.
Rank #4
- Handy for Work: Define each key and the knob in different commands as you need, then just one click to achieve specific command without input complex combination of shortcut keys
- UP to 16 Macros: Programmable keypad can create up to 16 macros, and each macro can max input 500 characters, enough for making program/game/office more efficiently
- 6 Layers User Setting: No need to repeat set, one-handed gaming keyboard is built-in storage function, enough for storage 6 layers different keys commands, and you can switch the layer on web or the software
- Web & Software Setting: Macro Keypad can be set on web or software, web setting for PC system Windows (7/9/10/11) and Mac OS, software setting for PC system Windows (10/11) and Mac OS,Not compatible with Linux system
- Hot Swap & Compact Design: The keypad supports hot swap function, plug and play; and in a compact size, perfect for gaming setups with limited desk space
Why the OLED labels matter
A conventional macro pad relies on memory, stickers or a software overlay to explain what each key does. FreeDeck puts that context on the device itself. You can change a key’s function and update its on-screen label instead of rebuilding your muscle-memory map from scratch. The six-display layout also makes different profiles easier to distinguish at a glance.
The SD-card reader is part of the documented prototype hardware, but the available project information does not establish a universal storage workflow or feature set for every firmware revision. Use the configurator and firmware documentation for the behavior supported by your chosen build.
Quick wins for a faster PC:
Scan for outdated or missing drivers - takes under a minuteDriver Scan →Clear out junk files and repair common Windows errorsFree Scan →Best Value
- Enjoy effortless customization of functions and robust, making this embedded keyboard a versatile addition to technical setups
- The 50 Keyboard Card delivers 50 programmable buttons to minimizes pin usage, optimizing circuit design for complex input tasks
- Built from durability ABS and equipped with an AVR MEGA8A microcontroller for stable operating it supports I2C or serialed port for seamlessly device integration in a compact form
- Ideal for engineers, developers, and enthusiasts creating embedded systems or customizable control
- Perfect for applications in industrial panels, and space constrained projects requiring reliabled, programmable input
FreeDeck versus buying a commercial macro keypad
| Decision factor | FreeDeck build | Commercial device |
|---|---|---|
| Assembly | You solder, program and test the hardware yourself | Ready-made hardware with no board assembly |
| Visible labels | OLEDs can identify each physical key | Depends on the model and its software or display hardware |
| Physical design | Choose a PCB route and print a matching case | Use the manufacturer’s fixed enclosure |
| Case compatibility | Must match the board revision, especially revisions 1.1–1.3 | Normally guaranteed by the product design |
| Cost and feature parity | Not established by the available project documentation | Varies by current model and software ecosystem |
The defensible comparison is about control and effort, not a claimed price advantage or parity with Elgato Stream Deck software. FreeDeck is attractive when you want an open, modifiable project and are willing to source parts, solder and print. A commercial keypad is the simpler choice when immediate setup and manufacturer-supported integration matter more than customization.
Pre-power checklist
- Board variant selected: through-hole or surface-mount.
- Controller is the documented 5 V ATmega32u4-based Pro Micro type, or a documented compatible replacement.
- Both 4051 multiplexers and all six display and button positions are accounted for.
- SSD1306 modules, tactile switches and SD-card reader match the board footprints and electrical requirements.
- Firmware and configurator correspond to the project files you used.
- Printed case explicitly matches the PCB revision.
- Every key label, OLED and storage function has been tested before final assembly.
Bottom line
Welch’s FreeDeck build is best understood as a refined, compact implementation of Gosewisch’s visual macro-keypad idea. Choose through-hole for a friendlier soldering path or surface-mount for a smaller unit, assemble the documented Pro Micro/4051/OLED hardware, and treat PCB-revision matching as mandatory when selecting the 3D-printed case. Its payoff is a customizable keypad whose displays tell you what each key does; its price is the time and care required to build and maintain it.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
