{"id":13733941,"url":"https://github.com/deckerego/MacroPad_Hotkeys","last_synced_at":"2025-05-08T10:30:35.103Z","repository":{"id":45576101,"uuid":"404501727","full_name":"deckerego/Macropad_Hotkeys","owner":"deckerego","description":"A derivative of the Macropad Hotkeys example from the Adafruit Learning System Guide","archived":false,"fork":false,"pushed_at":"2025-04-25T14:37:16.000Z","size":28,"stargazers_count":47,"open_issues_count":0,"forks_count":13,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-25T14:50:26.466Z","etag":null,"topics":["adafruit","circuitpython","keyboard","macropad","neopixel","rp2040"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deckerego.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-08T21:34:04.000Z","updated_at":"2025-04-25T14:35:39.000Z","dependencies_parsed_at":"2024-08-03T03:13:12.941Z","dependency_job_id":null,"html_url":"https://github.com/deckerego/Macropad_Hotkeys","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deckerego%2FMacropad_Hotkeys","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deckerego%2FMacropad_Hotkeys/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deckerego%2FMacropad_Hotkeys/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deckerego%2FMacropad_Hotkeys/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deckerego","download_url":"https://codeload.github.com/deckerego/Macropad_Hotkeys/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253045520,"owners_count":21845718,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adafruit","circuitpython","keyboard","macropad","neopixel","rp2040"],"created_at":"2024-08-03T03:00:51.103Z","updated_at":"2025-05-08T10:30:34.850Z","avatar_url":"https://github.com/deckerego.png","language":"Python","funding_links":[],"categories":["Macros"],"sub_categories":[],"readme":"# Macropad Hotkeys II\n\nA derivative of the\n[Macropad Hotkeys](https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/LICENSE)\nexample from the\n[Adafruit Learning System Guide](https://learn.adafruit.com/macropad-hotkeys/project-code).\n\n\n## Modifications\n\n- Rotary button no longer is an action, instead it turns on/off the displays\n- Macros for Blender, Safari, MIDI drum kit, generic number pad and Zoom\n- Support for HID consumer control codes\n- Support for mouse buttons\n- Support for sending MIDI notes\n- When no HID connection is present (power only), keep LEDs off and provide a message\n- Mount filesystem as read-only unless the encoder button is pressed on boot\n- Refactored the code to make it (maybe) easier to modify\n\n\n## Using\n\nYou use the Macropad Hotkeys much like the original\n[Adafruit version](https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/LICENSE),\nwith a few differences.\n\nUse the dial to select the macro template you would like to use. The macros appear\nin the order specified within each config file (see [Configuration](#configuration) below for details).\nOnce you have the macro you like selected, you are free to hammer away at the keys.\n\nClick the rotary dial to turn off the display \u0026 LEDs - click it again to turn it back on.\nNote the keys continue to respond even when they are not lit.\n\n\n## Configuration\n\nThe `macros/` folder has a list of macro templates to chose from, all of which\ncan be altered at your whim. First make sure to mount your Macropad in read/write\nmode (see [Updating](#updating)) and then open up the `.py` examples in the\n`macros/` folder. Note that each has a list of settings, including:\n\n- The name that will show at the top of the OLED display\n- The sequential order that it will be shown when rotating the encoder dial\n- A list of macros, sorted by row\n\nEach macro consists of an LED color, a label to appear on the OLED display,\nand a sequence of keys. A \"key\" can be text, a keyboard key, a consumer control\nkey (like play/pause), a mouse action, or a MIDI note. More than one key can\nbe specified in a sequence.\n\n\n## Installing\n\nFirst make sure that your Macropad has the\n[latest version of CircuitPython installed](https://circuitpython.org/board/adafruit_macropad_rp2040/).\nSee [https://learn.adafruit.com/adafruit-macropad-rp2040/circuitpython](https://learn.adafruit.com/adafruit-macropad-rp2040/circuitpython)\nfor instructions on how to update the Macropad to have the latest version of\nCircuitPython.\n\nWhen installing Macropad Hotkeys for the first time, extract the latest\n[MacroPad Hotkeys.zip](https://github.com/deckerego/Macropad_Hotkeys/releases/latest)\ninto a directory, then copy the contents of that extracted archive\ninto the CIRCUITPY drive that appears when you plug in your Macropad.\nEnsure that the contents of the `lib/` subdirectory are also copied - these are\nthe precompiled Adafruit libraries that power the Macropad.\n\n\n## Updating\n\nAfter you first install this version of Macropad Hotkeys and reboot the Macropad,\nthe CIRCUITPY filesystem will be mounted as read-only. When mounting the device\nas read-only, Windows and MacOS won't complain if you unplug or reboot the device\nwithout unmounting it, making it more like a regular old HID device.\n\nTo update or edit the code on the device, or to modify the macros, you first\nneed to reboot the device with the CIRCUITPY drive mounted in read/write mode.\nTo do that, reboot the device using the boot switch on the left of the\nMacropad, and then after releasing the button immediately hold down the\nrotary encoder button. You should see the text \"Mounting Read/Write\" quickly\nappear on the screen, and then the CIRCUITPY drive will mount in read/write mode.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeckerego%2FMacroPad_Hotkeys","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeckerego%2FMacroPad_Hotkeys","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeckerego%2FMacroPad_Hotkeys/lists"}