This is a customizable macro/hotkey launcher for the Adafruit MACROPAD. Rotate the encoder to switch between macro sets. Press any key to send custom keystrokes, commands, or strings over USB to the connected host.
Based on original code by Phillip Burgess / Adafruit With my modifications to code.py and custom macros. should be good for circuitpy 9.x firmware. If you get any issues such as import error, use the lib and requirements from Adafruit.
/code.py # Main runtime script
/macros/*.py # Folder of user-defined macro sets
/lib/ # Required CircuitPython libraries
/requirements/ # Optional extras, support tools, or scripts
-
Install CircuitPython on your MACROPAD (if not already installed).
-
Copy the included
uf2firmware file to the MACROPAD while in bootloader mode.- It will automatically reboot after flashing. This may take a few minutes.
-
Once rebooted, copy the following items to the root of the
CIRCUITPYdrive:code.py/macros/folder/lib/folder/requirements/folder (optional extras if included)
-
Add
.pymacro files inside/macros/to define custom key layouts. -
Plug the MACROPAD into your computer.
-
Use the rotary encoder to scroll through available macro profiles.
-
Press any key to send its configured action over USB.
Each file in /macros/ should contain a dictionary like this:
app = {
'name': 'ExampleApp',
'macros': [
(0xHEX, 'LABEL', ['Command or keystrokes']),
...
]
}0xRRGGBB: RGB color for key lighting (hex format)'LABEL': Text (≤5 characters) shown on the MACROPAD display['...']: List of actions (strings, delays, keycodes, etc.)
Colors are specified in hex format:
0xFF0000 → Red
0x00FF00 → Green
0x0000FF → Blue
You can use any valid RGB hex.
BY Satunix Based on original code by Phillip Burgess / Adafruit
MIT License — Free to use, modify, and redistribute.