Skip to content

macrodeck-config

Configures Macro Deck (source) by reading and writing its on-disk config directly, rather than clicking through the GUI. Macro Deck stores profiles (button layouts) as a JSON blob inside a SQLite database — this skill knows that schema, the JSON contract each installed plugin's actions use, and the safe read-close-write-reopen pattern needed to avoid corrupting a live config.

  • Area: Foundational
  • Category: utilities
  • Level: beginner
  • Input: conversation
  • Output: document
  • Setup: none
  • Roles:

Reads and edits Macro Deck (open-source Stream Deck alternative, macro-deck.app) button profiles by manipulating its on-disk config directly — profiles.db, config.json,…

How you ask

  • “Configure Macro Deck”
  • “Add a button to my macro deck”
  • “Macro deck hotkey”

Inputs

  • appdata_path — Path to the Macro Deck user directory (default %AppData%\Macro Deck via /mnt/c/Users//AppData/Roaming/Macro Deck)
  • button_specs — Desired buttons — label, action(s), grid position, optional status binding
  • plugin_repo_url — Plugin repo url used to clone a plugin's source to /tmp/repos and extract its Actions/*.cs $type + Configuration shape when the format is unknown

Outputs

  • action-catalog-entry (markdown)
  • config-summary (markdown)
  • mutation-script (python)
  • user-specified output path for action catalog entry
  • user-specified output path for config summary
  • {output.scripts}/macrodeck_add_buttons_{date}.py