mchilli / macropad

This is an Adafruit MacroPad script that allows you to manage your macros via a WebUI

MacroPad by MCHilli

This is an Adafruit MacroPad script that allows you to manage your macros via a WebUI.

---

Features:

• Make groups to organize your macros

• Groups can store more macros or groups

• Define encoder macros for different groups

• Choose colors for every single macro or group

• Save your configurations locally by downloading it as a JSON file

• Device settings:

  • Choose a keyboard layout suitable for your language
  • Set a display timeout to prevent burn-in
  • Use a Unicode Font (increases the font loading time)
  • Flip the rotation of the device by 180 degrees
  • Adjust the LCD and LED brightness

Installation:

Flash circuitpython on to your macropad, following this guide.

Then just extract the content of "macropad.zip" to your device.

Now just configure your macropad over the WebUI:

Connect → select MacroPad by MCHilli → Create Macros → Upload

If you are happy with your configuration don't forget to Store! Otherwise your macros will not be saved on your MacroPad and will also not appear after rebooting your device!

Other Informations:

Your can enable the USB storage either by pressing the yellow blinking key (top, left) when plugin the device, you can enable it through the WebUI under "reboot" or you can set a macro with the device function "enable_usb".

Ideas:

• Further translations for the WebUI. If you want to help me there is a template.json in the "lang" folder
• You tell me, feel free to contribute

---

Browser limitation:

The script use the Web Serial API for communication. The only browsers that currently support this API are Chrome, Edge and Opera, so unfortunately you'll have to use one of them.

Used libraries and icons:

• SortableJS
• Font Awesome

macropad's Issues

Allow brightness adjustment

Allow the user to adjust the brightness of all keys (perhaps a setting..)

Latest release fails to run

The latest release seems to fail. I get red blinks on the macro pad and it doesn't seem happy on a fresh copy.

Navigation

An idea to remove the void middle top button;

Instead of forcing the navigation to take up the top row - allow the user to define how they want to navigate between groups.

I.e., we can already place a group anywhere. You could add some new macro types / controls;

• Go back (steps back a level)
• Go to specific group (Allows you to jump to a group)

This way users could make use of the top row in any way they want. It also removes the need to have a voided button.

Allow rotation

Allow the user to orient the macro pad how they want. I.e., I want it rotated (so rotary knob on the bottom..).

Feature Requests

• Allow an easy way to copy / paste color codes between groups / macros. Currently I can't paste one hex code to another for example.
• Allow the use of icons for labels.
• Allow the default encoder function on the home / first page