Close
0%
0%

Macropad Hotkeys II

An extensible hotkey setup for the Adafruit Macropad with consumer controls, MIDI, mouse actions, and updates for real-world use

Similar projects worth following
An extensible hotkey macropad inspired by the Macropad Hotkeys example from the Adafruit Learning System Guide. This version allows you to:

- Have multiple pages of macros that you can scroll through (think of a set of macros for each DaVinci Resolve page)
- Support for HID consumer control codes
- Support for mouse buttons & scroll wheel
- Support for sending MIDI notes
- Boots without USB storage by default so your OS doesn't complain when unplugged
- Sleep after a configurable timeout so you don't have LED lights blasting all night
- Refactored the code to make it (maybe) easier to modify

These updates allow for you to use Hotkeys with Audacity, play/pause music, send mouse clicks, or easily issue app shortcuts.

Installation is pretty simple - assemble a Adafruit Macropad, then follow the installation instructions in the GitHub repository's README. You can be up and running in minutes!

Once the software is installed you can select from a pre-built macro page in the wiki or create one of your own - templates are supplied so you can send commands or keycodes with each button press or turn of the dial.

  • Version 4 Released & Bugs Ironed Out

    DeckerEgo03/27/2026 at 14:32 0 comments

    Version 4 is out (actually 4.3.1 as of today) and has a ton of new features, compatibility with CircuitPython 10, and UI fixes. This includes:

    • Mouse wheel support
    • New macro attribute: "launch." This will allow you to execute a key sequence when switching to a new screen on the macropod.
    • Allowed users to define what happens when the rotary encoder is rotated or pressed
    • "Sleeping" the display is now a command you can issue as a macro
    • LED & display timeout can now be configured per macro page
    • Moved pre-made macro pages out into the Wiki
    • Don't mount USB storage unless mounted in read/write mode
    • Latest Adafruit core libraries

    The next release will be more focused on animations - I'm working on allowing user-defined "shaders" to be applied during key press actions or when idle.

  • Version 4 Beta Released!

    DeckerEgo11/28/2025 at 16:59 0 comments

    I've redone a lot of things with the Macropad Hotkeys lately to better support workstations like DaVinci Resolve. A pre-release is already available, and after some testing will make this a latest release.

    Some changes:

    • New macro attribute: "launch." This will allow you to execute a key sequence when switching to a new screen on the macropod.
    • Allowed users to define what happens when the rotary encoder is rotated or pressed
    • "Sleeping" the display is now a command you can issue as a macro
    • LED & display timeout can now be configured per macro page
    • Moved pre-made macro pages out into the Wiki
    • "launch" parameter on macro pages to launch a key combination on start
    • Moar bugfixes

View all 2 project logs

Enjoy this project?

Share

Discussions

Similar Projects

Does this project spark your interest?

Become a member to follow this project and never miss any updates