{"id":13800196,"url":"https://github.com/prcutler/awesome-macropad","last_synced_at":"2025-09-29T10:31:33.864Z","repository":{"id":38378114,"uuid":"434300126","full_name":"prcutler/awesome-macropad","owner":"prcutler","description":"A curated list of awesome applications, macros, 3D printed cases, guides, and more for the Adafruit CircuitPython rp2040 MacroPad.","archived":false,"fork":false,"pushed_at":"2025-07-29T23:43:42.000Z","size":171,"stargazers_count":310,"open_issues_count":0,"forks_count":12,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-09-18T18:53:26.889Z","etag":null,"topics":["3d-printing","adafruit","awesome","awesome-list","circuitpython","macropad","macros","rp2040"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prcutler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-12-02T16:44:05.000Z","updated_at":"2025-09-17T18:02:21.000Z","dependencies_parsed_at":"2024-05-28T13:41:36.569Z","dependency_job_id":"5b8f5a82-a878-493a-958a-c77942442775","html_url":"https://github.com/prcutler/awesome-macropad","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/prcutler/awesome-macropad","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prcutler%2Fawesome-macropad","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prcutler%2Fawesome-macropad/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prcutler%2Fawesome-macropad/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prcutler%2Fawesome-macropad/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prcutler","download_url":"https://codeload.github.com/prcutler/awesome-macropad/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prcutler%2Fawesome-macropad/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277502636,"owners_count":25829203,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-29T02:00:09.175Z","response_time":84,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-printing","adafruit","awesome","awesome-list","circuitpython","macropad","macros","rp2040"],"created_at":"2024-08-04T00:01:10.358Z","updated_at":"2025-09-29T10:31:33.858Z","avatar_url":"https://github.com/prcutler.png","language":null,"funding_links":[],"categories":["Code","Other Lists"],"sub_categories":["Educational","TeX Lists"],"readme":"[![Awesome](https://awesome.re/badge.svg)](https://awesome.re) [![CC BY-SA 4.0][cc-by-sa-shield]][cc-by-sa]\n\n[cc-by-sa]: http://creativecommons.org/licenses/by-sa/4.0/\n[cc-by-sa-image]: https://licensebuttons.net/l/by-sa/4.0/88x31.png\n[cc-by-sa-shield]: https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg\n\n\u003e A curated list of awesome applications, macros, 3D printed cases, guides, and more for the [Adafruit CircuitPython rp2040 MacroPad](https://www.adafruit.com/product/5100).\n\n## Contents\n\n- [Contents](#contents)\n- [MacroPad Hardware](#macropad-hardware)\n- [MacroPad Guides](#macropad-guides)\n- [Applications](#applications)\n- [Games](#games)\n- [Macros](#macros)\n- [Other](#other)\n- [3D Printed Cases](#3d-printed-cases)\n- [Keycaps, Switches, and Plates](#keycaps-switches-and-plates)\n- [Contributing](#contributing)\n  - [Contribution Workflow Overview](#contribution-workflow-overview)\n- [License \u0026 Trademarks](#license--trademarks)\n\n## MacroPad Hardware\n\n- [MacroPad Hardware on Adafruit.com](https://www.adafruit.com/?q=MacroPad\u0026sort=BestMatch)\n- [PCB files](https://github.com/adafruit/Adafruit-MacroPad-RP2040-PCB) in EagleCAD schematic format.\n- [Stemma QT add-on boards from Adafruit](https://www.adafruit.com/?q=stemma+qt\u0026sort=BestMatch)\n- [Keycaps from Adafruit](https://www.adafruit.com/?q=keycaps\u0026sort=BestMatch)\n- [Black Relegendable Plastic Keycaps for MX Compatible Switches](https://www.adafruit.com/product/5662)\n- [MacroPadSynthPlug](https://github.com/todbot/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.\n- [Replacement OLED Display](https://www.adafruit.com/product/5228) - in case you get screen burn-in, the display can be replaced.\n\n## MacroPad Guides\n\n- [Getting Started with the Adafruit MacroPad](https://learn.adafruit.com/adafruit-MacroPad-rp2040) by Kattni Rembor\n- [Programming MacroPad Hotkeys](https://learn.adafruit.com/MacroPad-hotkeys) by Phillip Burgess\n- [Disable Mass Storage so the MacroPad doesn't show up as a CIRCUITPY Drive](https://learn.adafruit.com/customizing-usb-devices-in-circuitpython/circuitpy-midi-serial#circuitpy-mass-storage-device-3096583)\n- [Using the MacroPad for 2 Factor Authentication](https://learn.adafruit.com/MacroPad-2fa-totp-authentication-friend) by Carter Nelson\n- [Dragon Drop: a CircuitPython Game for the MacroPad](https://learn.adafruit.com/dragon-drop-a-circuitpython-game-for-MacroPad) by Phillip Burgess\n- [Control Home Assistant with the MacroPad](https://learn.adafruit.com/MacroPad-remote-procedure-calls-over-usb-to-control-home-assistant) by Melissa Leblanc-Williams\n- [Ableton Live MacroPad Launcher](https://learn.adafruit.com/ableton-live-MacroPad-launcher) - by John Park\n- [Minecraft Turbopad](https://learn.adafruit.com/minecraft-turbopad) by John Park\n- [Scrambled Number Doorlock Security Keypad](https://learn.adafruit.com/scrambled-number-security-keypad) by Anne Barela\n- [Install QMK on an Adafruit rp2040 MacroPad](https://learn.adafruit.com/using-qmk-on-rp2040-microcontrollers/adafruit-macropad-with-qmk) by Jeff Epler\n- [Create a MIDI Controller using Arduino](https://www.hackster.io/Code_and_Make/arduino-powered-adafruit-macropad-rp2040-midi-controller-33f437) by Code_and_Make\n\n## Applications\n\n- [METAR Display and airport status](https://github.com/flyinactor91/metarpad) by flyinactor91\n- [HP35 Calculator](https://github.com/funkfinger/adafruit-MacroPad-hp-35-calc) by funkfinger\n- [MIDI Launchgrid](https://github.com/zoul0813/adafruit-launchgrid) by zoul0813\n- [Open Broadcaster Software (OBS](https://github.com/djotaku/MacroPad_rp2040_hotkeys)) by djotaku\n- [BeePad](https://github.com/trickeydan/beepad) by trickeydan\n- [MacroPad-Sequencer](https://github.com/analogsketchbook/MacroPad-Sequencer) by analogsketchbook, an 8-step MIDI sequencer.\n- [Multiple Timers](https://github.com/alpiepho/MacroPad-timers) by alpiepho, a timer application that implements a set of 12 independent timers.\n- [BuildPad](https://github.com/willgorman/buildpad) by willgorman, a build automation tool for viewing and launching Jenkins jobs.\n- [The MacroPad 4chord MIDI](https://github.com/deckerego/Macropad_4chord_MIDI) is built to play simple chord progressions as a MIDI device on a rp2040 MacroPad by deckerego. [Demonstration Video](https://www.youtube.com/watch?v=Ifc-n-RV3Ag)\n- [App Pad](https://github.com/kbaskett248/adafruit_macropad) 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.\n- [MacroPad Automation and Application Detector](https://github.com/xhargh/MacropadApplicationDetector) is a Windows application that detects the currently active window and automatically switches to the appropriate set of macros for that application by xhargh.\n- [PyCurrentWindow](https://github.com/astridos2go/PyCurrentWindow) automatically detects the focused application and automatically changes to the correct macros by astridos2go. (Windows only)\n- [Macro Hotkeys + Extensions](https://github.com/notnavindu/adafruit-macropad-hotkeys-with-extensions) Modified version of Adafruit's [Hotkeys](https://learn.adafruit.com/macropad-hotkeys) script. Includes a Pomodoro timer, Bongo Cat and support to write your own extensions. By notnavindu\n- [Bongo Cat](https://github.com/christanaka/circuitpython-bongo) by christanaka\n- [The MacroPad Jukebox](https://www.hackster.io/iotitlan/the-macropad-jukebox-3d2c99) by Carlos Olmos\n- [Multiple MarcoPad Apps](https://github.com/ondras/macropad) by Ondřej Žára. Hotkey mappings for git, MIDI tones and/or chords, Elite:Dangerous game, DaVinci Resolve Color grading and more.\n- [Manage your MacroPad via a WebUI](https://github.com/mchilli/macropad) by MCHilli\n- [The MacropadPyDemo is a rewrite of the Arduino demo in CircuitPython](https://github.com/haugenmitch/MacropadPyDemo) by haugenmitch\n- [MacroSynth](https://github.com/obtusecanadiangoose/macrosynth), a basic osc synthesizer using Todbot's [MacroPadSynthPlug](https://github.com/todbot/macropadsynthplug) by obtusecanadiangoose\n- A [CHIP-8 emulator](https://github.com/cubbagesj/macropad_CHIP8) for the Adafruit MacroPad by cubbagesj\n- The [T9 Predictive MacroPad](https://github.com/dupontgu/t9-macropad-circuitpython/tree/main) is available for a number of boards, [including the Adafruit MacroPad](https://github.com/dupontgu/t9-macropad-circuitpython/tree/main/fw) by Guy Dupont.\n- Send MIDI commands to a loop pedal using the Adafruit MacroPad with [MIDILooper](https://github.com/dxinteractive/macropad-midilooper) by dxinteractive.\n- [Media hub and control with optional Bluetooth](https://adafruit-playground.com/u/Alain_ManHW/pages/media-hub-media-control-w-opt-bluetooth) by Alain_ManHW\n- [WOLFPUNK Chord Machine](https://github.com/wolfpunk25/wolfpunk-chords) by wolfpunk25. Transform your MacroPad into a powerful chord and arpeggiator performance tool with rich LED feedback and a dynamic OLED interface.\n\n## Games\n\n- [Macro Whack](https://github.com/coryflucas/macro-whack), a whack-a-mole style game for the MacroPad) by Cory Flucas\n- [Tic-Tac-Toe](https://github.com/robotastic/MacroPad-tic-tac-toe) by robotastic\n- [Game of Life](https://github.com/stelly-dev/game_of_life_adafruit_MacroPad) by stelly-dev\n- [BrainMAX](https://github.com/omixen/MacroPad-math-game) by omixen, a math game.\n\n## Macros\n\n- [Macros for Blender, Safari, MIDI drum kit, generic number pad and Zoom](https://github.com/deckerego/MacroPad_Hotkeys) by deckerego\n- [Vim Macros](https://github.com/CristinaSolana/adafruit-MacroPad-vim-macros) by Cristina Solana\n- [Microsoft Teams, YouTube, Number Pad and Zoom](https://github.com/de-mon/ADA-MacroPad) by de-mon (Tested on Windows)\n- [Final Fantasy XIV](https://github.com/Radical-Dreamr/adafruit_MacroPad_ffxiv) by Radical Dreamr\n- [Generic Windows commands and KiCad](https://github.com/AlpenglowIndustries/Adafruit_MacroPad_Hotkeys) by AlpenglowIndustries\n- [A funny vulnerability demonstration](https://github.com/prcutler/awesome-macropad) for unlocked and unattended Windows workstations by nihilexmachina.\n- Macros including a [universal numpad, macOS media control keys, Zoom, and Webex macros](https://github.com/armccoy/macropad-rp2040-hotkeys) by armccoy\n- macOS macros for [Evernote, Illustrator, Photoshop, Safari, Slack, Twitter, Zoom, and more](https://github.com/andypiper/ada-macropad) by andypiper.\n- [Fusion360 macros](https://github.com/schneik80/Macropad-fusion) by schneik80.\n- 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](https://github.com/armccoy/macropad-rp2040-hotkeys) by armccoy.\n- [YouTube macros for Microsoft Windows](https://github.com/DJDevon3/My_Circuit_Python_Projects/blob/main/Boards/raspberrypi/Adafruit%20Macropad%20RP2040/Jons%20Macropad/macros/win-youtube.py) by DJDevon3\n- [bettermacrosforadafruitmacropad](https://github.com/couchpotatochip21/bettermacrosforadafruitmacropad) adds the ability to show an image when changing macros by couchpotatochip21.\n- [Simple macro profile for Kicad](https://github.com/corndog2000/RP2040-MACROPAD-KICAD) designed to keep one hand on the macropad and your other hand on your mouse when in the PCB editor.\n- [Helldivers 2 Stratagem macros](https://adafruit-playground.com/u/squid_jpg/pages/easy-helldivers-ii-stratagem-macros-for-rp2040-macropad) by squid_jpg\n- A [collection of macros for Windows and Linux by nylar357](https://github.com/nylar357/macropad_custom) including GitHub, Firefox, Sleep, Twitter, Vim, and more.\n\n## Other\n\n- [MicroPython Board Support](https://github.com/mp-extras/ADAFRUIT_MacroPad) by mp-extras\n- Put your MacroPad to [sleep after 5 minutes](https://github.com/M-Eldin/Adafruit-MacroPad-RP2040-Sleep) by m-eldin\n- [A refactored implementation](https://github.com/rossmoody/macropad-hotkeys) of the [MacroPad helper library](https://github.com/adafruit/Adafruit_CircuitPython_MacroPad) by rossmoody\n- [Fruity Menu](https://github.com/greatest-gatsby/fruity_menu) is a library for building simple UI menus for CircuitPython powered devices, including the rp2040 MacroPad.\n- [Mgogo](https://github.com/calbert1209/mgogo) is a library to convert Adafruit MarcoPad RP4020 settings to and from binary for read and write to the microcontroller's non-volatile memory.\n\n## 3D Printed Cases\n\n- [MacroPad RP2040 Case](https://www.thingiverse.com/thing:4910369) by Adafruit\n- [Adafruit MacroPad Case](https://www.thingiverse.com/thing:4910369) for square keys by nlapenn.\n- [MacroPad Print-In-Place Stand](https://www.thingiverse.com/thing:4907946) by Adafruit\n- [Adafruit MacroPad Case for square keycaps](https://www.thingiverse.com/thing:4922256) by nlapenn.\n- [Adafruit MacroPad Stand](https://www.thingiverse.com/thing:4900504) by Nyghtpoison.\n- [MacroPad Bumper](https://www.thingiverse.com/thing:4926336) by jepler.\n- [MacroPad LCD Wedge](https://www.thingiverse.com/thing:4947602) by srtnate.\n- [MacroPad CAD 3Dconnexion Space Mouse](https://www.thingiverse.com/thing:4928292) by nmsr1196.\n- [Merlin Case](https://www.thingiverse.com/thing:5118991) by ktanner\n- [MacroPad RP2040 Snap Together Case](https://www.thingiverse.com/thing:4935552) by obe\n- [MacroPad Notched Stand with holder and rotary cover](https://www.thingiverse.com/thing:4907845)\n- [Six degree angle MacroPad case](https://www.thingiverse.com/thing:5180029) by toasto\n- [45 degree stand](https://www.thingiverse.com/thing:5209578) for the six degree case above by simonbugler\n- [MacroPad Case and Stand](https://www.thingiverse.com/thing:5185595) by PaintBallGamer\n- [MacroPad Notched Stand, Holder and Rotary Cover](https://www.thingiverse.com/thing:4907845) by nmsr1196\n- [High Angle MarcoPad Stand](https://www.thingiverse.com/thing:4911282) by nmsr1196\n- [Modular Mounting Bracket](https://www.thingiverse.com/thing:5191519) by GloryFish\n- [MacroPad case with two extra rotary encoders and second display](https://www.thingiverse.com/thing:5413512)\n- [Hinged MacroPad Kickstand](https://learn.adafruit.com/3d-printed-stand-for-macropad-rp2040) by the Ruiz brothers at Adafruit\n- [MacroPad rp2040 Stand](https://www.thingiverse.com/thing:5460682) by miekush\n- [MacroPad switch plate](https://www.printables.com/model/91048-adafruit-macropad-rs2040-switch-plate) by NascentMaker\n- The [Key Tickler](https://www.printables.com/model/578085-key-tickler-adafruit-macropad) adds two 1x4 Stemma QT Neokeys and 3 Stemma QT rotary encoders, all enclosed in one case by jdireen\n- [MacroPad Dock](https://www.printables.com/model/588896-macropad-dock) that also pairs with a [Stream Deck](https://www.printables.com/model/588891) by Spacejocks\n- [Custom MacroPad Stand](https://www.printables.com/model/711899-adafruit-macropad-custom-stand) by carlos105420\n- [MacroPad Travel Lid and Stand](https://www.printables.com/model/612936-adafruit-macropad-rp2040-travel-lid-and-stand) by LALAG\n- [Macropad custom stand](https://www.printables.com/model/711899-adafruit-macropad-custom-stand/comments) by Vash\n- [Angled Stand](https://www.printables.com/model/920611-angled-stand-for-adafruit-macropad-case) by Splemsby\n\n## Keycaps, Switches, and Plates\n\n- [CNC Milling Keycaps](https://www.thingiverse.com/thing:4941235) by Adafruit\n- [MacroPad Braille Keycaps](https://www.thingiverse.com/thing:4913712) by Adafruit\n- [Adafruit MacroPad Keycaps](https://www.thingiverse.com/thing:4933949) by jepler, featuring a keycap made of a single piece that allows the LEDs to shine through.\n- [MacroPad switch plate](https://www.thingiverse.com/thing:4944190) by NascentMaker\n- [MacroPad Upright Stand](https://www.thingiverse.com/thing:4911282) by nms1196\n- [Nine degree stand](https://www.thingiverse.com/thing:4943775) to match Keychron keyboard angle by IcanCwhatUsay\n\n## Contributing\n\nContributions and suggestions are always welcome! Please make pull requests from your own fork to modify Awesome MacroPad.\n\nImposter syndrome disclaimer: I want your help. No really, I do.\n\nThere 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.\n\nI assure you, that's not the case.\n\nThe 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.\n\nThank you for contributing!\n\nThe workflow is similar to the one explained in detail here for CircuitPython: [Adafruit : Contribute to CircuitPython with Git and GitHub](https://learn.adafruit.com/contribute-to-circuitpython-with-git-and-github/overview).\n\n### Contribution Workflow Overview\n\nYou can either add a thread to our [GitHub Discussions](https://github.com/prcutler/awesome-macropad/discussions) or send a pull request to add your MacroPad creation to the awesome-list.\n\nIf you would like to submit a pull request:\n\n1. Fork [this repository](https://github.com/prcutler/awesome-MacroPad) on GitHub.\n1. Clone the forked repo to your drive.\n1. Add a remote using owner adafruit and the original URL.\n1. Fetch the remote.\n1. Merge main.\n1. Create a branch.\n1. Make a change.\n1. Commit and push to your repo.\n1. Create a pull request on the official repo.\n1. Once accepted, repeat by merging from the official repo to your fork's master, and re-branch.\n\nIt's easier than it looks!  Have questions or need help?  You can [find me on the Adafruit Discord](https://discord.com/invite/5FBsBHU) 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.\n\n## License \u0026 Trademarks\n\nThis work is licensed under a\n[Creative Commons Attribution-ShareAlike 4.0 International License][cc-by-sa].\n\n[![CC BY-SA 4.0][cc-by-sa-image]][cc-by-sa]\n\nLast Updated: July 29, 2025\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprcutler%2Fawesome-macropad","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprcutler%2Fawesome-macropad","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprcutler%2Fawesome-macropad/lists"}