Macro-Deck

Macro Deck

Macro Deck is the open-source macro pad for Windows, macOS and Linux that lets you create fully customizable control surfaces for your workflows. Organize your setup into profiles and folders, then fill them with interactive widgets such as action buttons, sliders, media controls, weather displays and more.

Use Macro Deck from your phone, tablet or compatible hardware to control applications, services and devices from one place.

Macro Deck 3 is currently under active development and may contain incomplete or unstable functionality.

Platforms

The Macro Deck host runs on:

• Windows
• macOS
• Linux

Debian and Ubuntu

Macro Deck is available from its APT repository for 64-bit x86 systems:

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSLo /etc/apt/keyrings/macro-deck.asc https://packages.macro-deck.app/gpg.asc
sudo tee /etc/apt/sources.list.d/macro-deck.sources > /dev/null <<'EOF'
Types: deb
URIs: https://packages.macro-deck.app
Suites: stable
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/macro-deck.asc
EOF
sudo apt update
sudo apt install macro-deck

Updates then arrive with sudo apt upgrade. Use Suites: beta to receive prereleases as well. The stable suite carries packages from the first stable Macro Deck 3 release on.

What makes Macro Deck different

Flexible by design

Create multiple profiles, organize them using folders and build your control surfaces from interactive widgets. Widgets can be simple action buttons or richer controls and displays such as sliders, media players, weather information and more.

Automate workflows and control supported applications, services and devices through built-in integrations, or extend Macro Deck with plugins using the public plugin SDK and protocol.

Web-based architecture

Macro Deck is built around a web-based architecture. Configure and control your setup from any modern browser on your network, including browser-based game overlays.

The web client can be used directly as a macro pad without installing a native companion app. With HTTPS enabled, it can also be installed as a PWA, providing an alternative for devices where a native companion app is not available.

Native companion apps and compatible hardware can connect to the same Macro Deck host.

Companion app

The Macro Deck companion app is optional. It is a native alternative to the web client that offers better performance and additional features.

The companion app is available for a one-time license fee. Buying it directly supports the ongoing development of Macro Deck.

Platform	Download
Android	Get it on Google Play
iOS	Download on the App Store

Security-first plugin ecosystem

Content distributed through the official Macro Deck Store is reviewed before publication. Plugins, icon packs, templates and other submitted content are checked for potentially harmful behavior, unexpected data access and other security risks before they are accepted.

Approved packages are hosted by Macro Deck infrastructure and cryptographically signed by the Store. Macro Deck verifies this signature during installation and clearly warns when a plugin or other package does not originate from the trusted Store distribution path.

Because the Store distributes the reviewed package itself rather than relying on a developer-controlled download, an approved package cannot be silently replaced or modified by its developer without going through the Store process again.

Manual installation and development of third-party plugins remain possible, but packages outside the trusted Store distribution path are clearly distinguishable from Store-signed packages.

Developing for Macro Deck

Macro Deck provides a public plugin SDK, tooling and documentation for building plugins and integrations.

• Developer documentation
• Plugin template
• Agent skills for coding agents
• Engineering documentation
• Development setup

Contributing and community

Contributions and feedback are welcome. Please read the contribution guidelines before submitting changes.

• GitHub issues
• Discord community
• Macro Deck website

License

Macro Deck is open-source software licensed under the Apache License 2.0. See NOTICE for additional legal notices and THIRD-PARTY-NOTICES for the third-party components Macro Deck includes and their licenses.

Trademarks and branding

The Macro Deck name, logo and branding assets are not covered by the Apache License 2.0. They are licensed exclusively to the Macro Deck project. Forks and other derived products must use their own name and branding and replace the logo, icons and other branding assets. See NOTICE.

Special thanks

JetBrains provides licenses used for Macro Deck development.