prcutler/awesome-macropad

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

Contents

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

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

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

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 Macropad 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
• 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.
• The MacroPad Jukebox by Carlos Olmos

Games

• Macro Whack, a whack-a-mole style game for the MacroPad) by Cory Flucas
• Tic-Tac-Toe by robotastic
• Game of Life by stelly-dev
• BrainMAX by omixen, a math game.

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.

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

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 Macropad 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

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: May 21, 2023