A derivative of the Macropad Hotkeys example from the Adafruit Learning System Guide.
I wanted to define more complex configurations than what was easily possible with the original Adafruit Macropad Hotkeys code. This project has several advanced features beyond the original project.
- Rather than switching macro sets with the encoder, you may choose to switch macro sets with keys. This allows you to define menu-based switchers, making it much faster to get to the desired set. It also frees up the rotary encoder for use as a volume knob, scrubber, or anything else.
- Each key can define an OS-specific variant. This allows you to switch up which keystrokes are sent depending on the OS you've selected.
- Double-tap support so you can define a second command for each key, giving you 24 possible commands per macro set.
- Basic timers that run callbacks. This can be used for many things, including disabling the key LEDs after a period of inactivity.
- An App-based model where the App is responsible for control flow. This allows including other types of Apps with completely different behavior, like games, alongside your macros.
Just like with the original Macropad Hotkeys code, copy all the files over to your Circuitpy drive.
The existing layout has a Home App with the following features:
- A key for selecting the platform (Linux, Mac OS, or Windows).
- Media playback controls
- The rotary encoder controls volume, and the button mutes.
- Keys for jumping to the following apps
- Numpad
- Navigation cluster, with arrows, Home, End, Page Up, and Page Down
- Function Keys
- A Window Management app which allows switching virtual desktops and quickly resizing windows. Note that this requires defining hotkeys on the host computer.
- An app switcher you can use to quickly swap to your most used desktop programs. Some programs may have their own associated macro apps which open when switching to them. Note that this may also require defining hotkeys on the host computer.