Macropad RP2040 Hotkeys
A growing collection of CircuitPython-based hotkey macros for the Adafruit Macropad RP2040.
Currently, the following macro sets are included:
- Universal numpad
- Media Control Hotkeys (MacOS)
- Zoom (MacOS)
- Webex (MacOS)
- MS Teams (MacOS)
- Google Meet (MacOS)
- Discord (Win)
- Sea of Thieves (Win)
Configuration
The macros/ directory contains the collection of macros, each set in its own file with the .py extension. Each set contains the following:
- The name of the application that the macro targets
- List of macros, sorted by row
Any new macros added to the macros/ directory will be scanned and included when the device boots.
The lib/ directory contains the necessary Adafruit Macropad libraries. See the README in the lib/ directory in this project for more information.
Installing
First make sure that your Macropad has the latest version of CircuitPython installed. See https://learn.adafruit.com/adafruit-macropad-rp2040/circuitpython for instructions on how to update the Macropad to have the latest version of CircuitPython.
The project files can then be uploaded to the root directory of the device.
Updating
After first installing this code and rebooting the Macropad, the CIRCUITPY filesystem will be mounted as read-only. When mounting the device as read-only, Windows and MacOS won't complain if the device is unplugged or rebooted without unmounting it, making it more like a regular old HID device.
To update or edit the code on the device, or to modify the macros, reboot the device with the CIRCUITPY drive mounted in read/write mode. To do that, press the boot switch on the left of the Macropad, and then after releasing the button, immediately hold down the rotary encoder button. The text "Mounting Read/Write" should quickly appear on the screen, and then the CIRCUITPY drive will mount in read/write mode.
Related Projects
Much thanks to the following related projects: