Macro Deck

September 13, 2026 ยท View on GitHub

Macro Deck

Macro Deck

CI License

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.

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

NuGet

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

Contributing and community

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

License

Macro Deck is open-source software licensed under the Apache License 2.0. See NOTICE for additional attribution and legal notices.

Special thanks

JetBrains provides licenses used for Macro Deck development.