awesome-macropad

A curated list of awesome applications, macros, 3D printed cases, guides, and more for the Adafruit CircuitPython rp2040 MacroPad.

Contents

• Contents
• MacroPad Hotkeys II
• MacroPad Hardware
• MacroPad Guides
• Applications
• Games
• Macros
• Other
• 3D Printed Cases
• Keycaps, Switches, and Plates
• Contributing
  • Contribution Workflow Overview
• License & Trademarks

MacroPad Hotkeys II

Looking to get more out of your MacroPad and build upon the default Adafruit MacroPad experience? Check out MacroPad Hotkeys II (GitHub repository and Hackaday project page) by DeckerEgo. It improves the default Macropad experience by adding support for multi-page macros, mount the Macropad in read-only mode, and maybe most importantly, sleep the display and add a display timeout to avoid OLED burn-in, and more. - It also includes example macros for Blender, DaVinci Resolve, Audacity, a Number Pad, and more. - Overview video

MacroPad Hardware

• MacroPad Hardware on Adafruit.com
• PCB files in EagleCAD schematic format.
• Stemma QT add-on boards from Adafruit
• Keycaps from Adafruit
• Black Relegendable Plastic Keycaps for MX Compatible Switches
• MacroPadSynthPlug is a small board that plugs into the StemmaQT port and gives you TRS-A MIDI In and Audio line out and allows it to be a stand-alone MIDI synth by todbot.
• Replacement OLED Display - in case you get screen burn-in, the display can be replaced.

MacroPad Guides

• Getting Started with the Adafruit MacroPad by Kattni Rembor
• Programming MacroPad Hotkeys by Phillip Burgess
• Disable Mass Storage so the MacroPad doesn't show up as a CIRCUITPY Drive
• Using the MacroPad for 2 Factor Authentication by Carter Nelson
• Dragon Drop: a CircuitPython Game for the MacroPad by Phillip Burgess
• Control Home Assistant with the MacroPad by Melissa Leblanc-Williams
• Ableton Live MacroPad Launcher - by John Park
• Minecraft Turbopad by John Park
• Scrambled Number Doorlock Security Keypad by Anne Barela
• Install QMK on an Adafruit rp2040 MacroPad by Jeff Epler
• Create a MIDI Controller using Arduino by Code_and_Make

Configuration Utilities

• Manage your MacroPad via a WebUI by MCHilli
• MacroPad Configurator by AlexanderPotashko is a Windows application to configure your MacroPad. It can audo-detect your Macropad, manage multiple profiles, includes a visual editor and keyboard, includes 12 pre-configured macro templates, and more.

Applications

• METAR Display and airport status by flyinactor91
• HP35 Calculator by funkfinger
• MIDI Launchgrid by zoul0813
• Open Broadcaster Software (OBS) by djotaku
• BeePad by trickeydan
• MacroPad-Sequencer by analogsketchbook, an 8-step MIDI sequencer.
• Multiple Timers by alpiepho, a timer application that implements a set of 12 independent timers.
• BuildPad by willgorman, a build automation tool for viewing and launching Jenkins jobs.
• The MacroPad 4chord MIDI is built to play simple chord progressions as a MIDI device on a rp2040 MacroPad by deckerego. Demonstration Video
• App Pad An advanced port of Adafruit's MarcoPad application that adds switching macros by keys, OS-specific variants, double-tap support, and callback timers by kbaskett248.
• MacroPad Automation and Application Detector is a Windows application that detects the currently active window and automatically switches to the appropriate set of macros for that application by xhargh.
• PyCurrentWindow automatically detects the focused application and automatically changes to the correct macros by astridos2go. (Windows only)
• Macro Hotkeys + Extensions Modified version of Adafruit's Hotkeys script. Includes a Pomodoro timer, Bongo Cat and support to write your own extensions. By notnavindu
• Bongo Cat by christanaka
• The MacroPad Jukebox by Carlos Olmos
• Multiple MarcoPad Apps by Ondřej Žára. Hotkey mappings for git, MIDI tones and/or chords, Elite:Dangerous game, DaVinci Resolve Color grading and more.
• The MacropadPyDemo is a rewrite of the Arduino demo in CircuitPython by haugenmitch
• MacroSynth, a basic osc synthesizer using Todbot's MacroPadSynthPlug by obtusecanadiangoose
• A CHIP-8 emulator for the Adafruit MacroPad by cubbagesj
• The T9 Predictive MacroPad is available for a number of boards, including the Adafruit MacroPad by Guy Dupont.
• Send MIDI commands to a loop pedal using the Adafruit MacroPad with MIDILooper by dxinteractive.
• Media hub and control with optional Bluetooth by Alain_ManHW
• WOLFPUNK Chord Machine by wolfpunk25. Transform your MacroPad into a powerful chord and arpeggiator performance tool with rich LED feedback and a dynamic OLED interface.
• cloudfx by Wchesher turns two Adafruit devices into a sound effect and macro controller system, such as a MacroPad and FunHouse.
• homebridge-macropad by maximkulkin is a Homebridge plugin to integrate an Adafruit rp2040 MacroPad into HomeKit using TypeScript.
• Use your MacroPad as a USB Digital Effects Pedal by foamyguy

Games

• Macro Whack, a whack-a-mole style game for the MacroPad) by Cory Lucas
• Tic-Tac-Toe by robotastic
• Game of Life by stelly-dev
• BrainMAX by omixen, a math game.
• [MacroPadGames by messerjon] are a collection of 11 mini-games for the Adafruit MacroPad. Games include Simon Says, Whack-a-Mole, Reaction, Piano, and more.

Macros

• Macros for Blender, Safari, MIDI drum kit, generic number pad and Zoom by deckerego
• Vim Macros by Cristina Solana
• Microsoft Teams, YouTube, Number Pad and Zoom by de-mon (Tested on Windows)
• Final Fantasy XIV by Radical Dreamr
• Generic Windows commands and KiCad by AlpenglowIndustries
• A funny vulnerability demonstration for unlocked and unattended Windows workstations by nihilexmachina.
• Macros including a universal numpad, macOS media control keys, Zoom, and Webex macros by armccoy
• macOS macros for Evernote, Illustrator, Photoshop, Safari, Slack, Twitter, Zoom, and more by andypiper.
• Fusion360 macros by schneik80.
• A collection of macros for Windows and macOS that includes a universal numpad, macOS media control keys, Zoom, Webex, Discord, Sea of Thieves, and more by armccoy.
• YouTube macros for Microsoft Windows by DJDevon3
• bettermacrosforadafruitmacropad adds the ability to show an image when changing macros by couchpotatochip21.
• Simple macro profile for Kicad designed to keep one hand on the macropad and your other hand on your mouse when in the PCB editor.
• Helldivers 2 Stratagem macros by squid_jpg
• A collection of macros for Windows and Linux by nylar357 including GitHub, Firefox, Sleep, Twitter, Vim, and more.
• Macros by Ondra for git workflows, DaVinci Resolve color grading, playing MIDI chords, and the game Elite: Dangerous.

Other

• MicroPython Board Support by mp-extras
• Put your MacroPad to sleep after 5 minutes by m-eldin
• A refactored implementation of the MacroPad helper library by rossmoody
• Fruity Menu is a library for building simple UI menus for CircuitPython powered devices, including the rp2040 MacroPad.
• Mgogo is a library to convert Adafruit MacroPad RP4020 settings to and from binary for read and write to the microcontroller's non-volatile memory.

3D Printed Cases

• MacroPad RP2040 Case by Adafruit
• Adafruit MacroPad Case for square keys by nlapenn.
• MacroPad Print-In-Place Stand by Adafruit
• Adafruit MacroPad Case for square keycaps by nlapenn.
• Adafruit MacroPad Stand by Nyghtpoison.
• MacroPad Bumper by jepler.
• MacroPad LCD Wedge by srtnate.
• MacroPad CAD 3Dconnexion Space Mouse by nmsr1196.
• Merlin Case by ktanner
• MacroPad RP2040 Snap Together Case by obe
• MacroPad Notched Stand with holder and rotary cover
• Six degree angle MacroPad case by toasto
• 45 degree stand for the six degree case above by simonbugler
• MacroPad Case and Stand by PaintBallGamer
• MacroPad Notched Stand, Holder and Rotary Cover by nmsr1196
• High Angle MarcoPad Stand by nmsr1196
• Modular Mounting Bracket by GloryFish
• MacroPad case with two extra rotary encoders and second display
• Hinged MacroPad Kickstand by the Ruiz brothers at Adafruit
• MacroPad rp2040 Stand by miekush
• MacroPad switch plate by NascentMaker
• The Key Tickler adds two 1x4 Stemma QT Neokeys and 3 Stemma QT rotary encoders, all enclosed in one case by jdireen
• MacroPad Dock that also pairs with a Stream Deck by Spacejocks
• Custom MacroPad Stand by carlos105420
• MacroPad Travel Lid and Stand by LALAG
• Macropad custom stand by Vash
• Angled Stand by Splemsby

Keycaps, Switches, and Plates

• CNC Milling Keycaps by Adafruit
• MacroPad Braille Keycaps by Adafruit
• Adafruit MacroPad Keycaps by jepler, featuring a keycap made of a single piece that allows the LEDs to shine through.
• MacroPad switch plate by NascentMaker
• MacroPad Upright Stand by nms1196
• Nine degree stand to match Keychron keyboard angle by IcanCwhatUsay

Contributing

Contributions and suggestions are always welcome! Please make pull requests from your own fork to modify Awesome MacroPad.

Imposter syndrome disclaimer: I want your help. No really, I do.

There might be a little voice inside that tells you you're not ready; that you need to do one more tutorial, or learn another framework, or write a few more blog posts before you can help me with this project.

I assure you, that's not the case.

The contribution guidelines below outline the process that you'll need to follow to get a patch merged. By making expectations and process explicit, I hope it will make it easier for you to contribute.

Thank you for contributing!

The workflow is similar to the one explained in detail here for CircuitPython: Adafruit : Contribute to CircuitPython with Git and GitHub.

Contribution Workflow Overview

You can either add a thread to our GitHub Discussions or send a pull request to add your MacroPad creation to the awesome-list.

If you would like to submit a pull request:

1. Fork this repository on GitHub.
2. Clone the forked repo to your drive.
3. Add a remote using owner adafruit and the original URL.
4. Fetch the remote.
5. Merge main.
6. Create a branch.
7. Make a change.
8. Commit and push to your repo.
9. Create a pull request on the official repo.
10. Once accepted, repeat by merging from the official repo to your fork's master, and re-branch.

It's easier than it looks! Have questions or need help? You can find me on the Adafruit Discord as Paul Cutler. You can also find me on Twitter as @prcutler - feel free to ask me for help, I'm more than happy to help.

License & Trademarks

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Last Updated: July 6, 2026