Macro Deck is the open-source macro pad for Windows, macOS and Linux. Build your setup from buttons, sliders, media controls and live widgets, and control apps, services and devices from one place.

Download
GitHubJoin the DiscordDiscord
The Macro Deck 3 desktop app on macOS with a deck of widgets: a music player, a clock, the weather in Berlin, a volume slider, a CPU graph and buttons for Mute Mic, Go Live, Save Clip and Focus

Set up in a few minutes

Your computer runs Macro Deck. Your other devices only need a browser or the Companion app.

  1. Install Macro Deck

    On the Windows, macOS or Linux computer you want to control.

  2. Connect your devices

    Open the free web client in the browser of any phone, tablet, or computer on the same network, or use the optional Companion app for Android and iOS.

  3. Build your deck

    Arrange profiles, folders and widgets on your computer. Connected devices update right away.

  4. Connect your apps

    Turn on the integrations you use, like OBS Studio or Home Assistant, and put their actions on buttons.

How does it work?

Macro Deck runs on your computer and does the work there. Your phone shows the same deck and sends your presses, and every change reaches every connected device on its own.

Your computerRuns Macro Deck and your actions
Your phoneShows your deck and sends presses

  1. Your computer changes

    The volume changes on your computer. Macro Deck shows it on the deck there and sends the new value to your phone.

  2. You press a button

    Your phone runs nothing itself. It tells your computer which button you pressed.

  3. Your computer runs the action

    Macro Deck toggles the microphone on your computer, and the button there changes first.

  4. Your phone follows

    Your computer sends the button's new look back, and your phone shows it, as every connected device does.

Slowed down here so you can follow along. In practice, Macro Deck syncs within a few milliseconds over Wi-Fi and in under a millisecond over USB.

Flexible by design

Organize your setup into profiles and folders, and fill them with widgets that do more than run a shortcut.

Why choose Macro Deck?

Widgets for every job

A tile on your deck can be more than a button. Mix these widgets freely and size them to fit your layout.

Widgets on a deck: a music player with album cover, a clock, the weather with a three-day forecast, a vertical volume slider, a CPU usage graph and action buttons with icons

Music Player

Show what's playing on a connected music provider

A gauge widget from a plugin, showing 70 km/h on a half-circle dial

Add your own widgets with plugins

Plugins can add widget types of their own, and Macro Deck draws them on every device like the built-in ones.

Read how widget types work

Real logic, not just shortcuts

Give a button actions for a short press, a long press, a double tap or an event, and build them into flows. Branch with If, Else if and Else, combine conditions on live variables, repeat steps and wait in between.

This Go live button checks whether you are already streaming, refuses to start while the CPU is busy, and otherwise lowers the music, sets its border to blink, presses your streaming hotkey and turns green.

The action flow of a Go live button: an If / Else with an Else if that combines two conditions, and an Otherwise branch with a Repeat loop, a Wait, hotkeys, variables and color changes

Make every button your own

Pick background, label and icon colors, bring your own icons and frame them with zoom, position and opacity. Choose fonts and label positions, and add borders that glow, blink or cycle through colors.

Every state of a button gets its own look, so a mic button can be green while live and red while muted. With state mapping it follows a variable instead, for example your mute status in Discord. Put live values such as a {{ vars.deaths }} counter into any label.

The appearance settings of a Mic button with two states: background color, icon, icon color and icon framing

Automations without a button

Get your deck ready for the evening stream at 18:00 every day, or react when a device connects, a variable changes or OBS starts streaming.

The automation Evening stream: every day at 18:00 it changes the profile, sets the Spotify volume and sends a notification

Build your own plugins

The .NET SDK gives your plugin the same contracts the built-in integrations use: actions, variables, events, widgets and setup screens.

Start from the template, run it with hot reload and check it with the conformance tests, or let your AI coding agent build it with the Macro Deck plugin skill. The Creator Portal reviews and signs every version before it reaches the Store.

Build your first plugin
~ % macrodeck-plugin new --name "Hello Deck" --publisher Acme -yCreated plugin project at '~/HelloDeck'.Manifest: ~/HelloDeck/src/HelloDeck/manifest.jsonBuild configuration: ~/HelloDeck/src/HelloDeck/macrodeck-build.json~ % cd HelloDeck/src/HelloDeckHelloDeck % macrodeck-plugin run --project . --watchUsing host at http://127.0.0.1:52417.Developer Mode is enabled; a pairing prompt will appear in Macro Deck.Started process 70511 (mode: SelfRegistering, host: http://127.0.0.1:52417). Press Ctrl-C to stop.Watching the project: a saved change is applied with .NET Hot Reload, or rebuilds and restarts the plugin. Open developer previews in Macro Deck follow along.[plugin] dotnet watch 🔥 Hot reload enabled. For a list of supported edits, see https://aka.ms/dotnet/hot-reload.[plugin] dotnet watch 💡 Press Ctrl+R to restart.[plugin] dotnet watch 🔨 Building ~/HelloDeck/src/HelloDeck/HelloDeck.csproj ...[plugin] dotnet watch 🔨 Build succeeded: ~/HelloDeck/src/HelloDeck/HelloDeck.csproj...[plugin] info: MacroDeck.Plugin.Hosting.Transport.PluginConnectionHostedService[0][plugin]       Registered with the host as '"com.example.hello-deck"'....[plugin] info: HelloDeck.PluginIntegration[0][plugin]       Initialized.^CStopping the plugin...The plugin exited within its 10s grace period.HelloDeck % macrodeck-plugin test --project .Macro Deck plugin conformance report (suite 1.3.0)Plugin: com.example.hello-deck 1.0.0Started: 2026-10-21T18:20:41.3954460+00:00, duration: 00:00:21.6978993Passed: 25, Failed: 0, Skipped: 24Conformant: yes[PASS] MDC0101 The plugin id is a valid reverse-domain package id (Required)[PASS] MDC0102 Every declared capability's local id is a valid declared-kind identifier (Required)...HelloDeck % macrodeck-plugin buildBuilding linux-x64...Building osx-arm64...Building win-x64...Built linux-x64, osx-arm64, win-x64.Packed com.example.hello-deck 1.0.0 -> ./com.example.hello-deck-1.0.0.macroDeckPlugin (46 entries, 5491783 bytes uncompressed).HelloDeck %
Reusable scripts
Put actions you need in several places, like going live, into a script and use it from any button.
Built for the browser
Use any modern browser on your network, even in browser-based game overlays. With HTTPS, install the web client as an app.
Several devices at once
Every device can open with its own profile.
Coming from Macro Deck 2
Integrations such as OBS Studio and Discord take over the settings of the matching Macro Deck 2 plugin.
A Store you can trust
Plugins, icon packs and templates in the Macro Deck Store are reviewed before publication and signed, so a package cannot be swapped out afterwards.
Free and open source
Macro Deck and its built-in web client are free, Apache 2.0 licensed and developed on GitHub. The native Companion apps for Android and iOS are optional and need a one-time license after a 7-day trial.

33 built-in integrations

Control the applications, services and devices you already use. These ship with Macro Deck, turn on the ones you need.

All integrations

Download

Install Macro Deck on your computer, then connect your phone, tablet, or web browser.

Macro Deck

Installer for Windows, an app for Apple silicon Macs, and an APT repository, .deb, .rpm and AppImage for Linux.

Open the installation guide

Free and open source

Connect your devices

Control Macro Deck from your phone, tablet, or any web browser.

Web Client

No installation required. Open your Macro Deck host's address in a browser on your local network.

Free and open source, bundled with Macro Deck

Android Companion App

7-day free trial · One-time purchase, lifetime access

Google Play
iOS Companion App

7-day free trial · One-time purchase, lifetime access

App Store

The Companion app is optional. One license unlocks it on both Android and iOS, and it is a one-time purchase with lifetime access, not a subscription. The license helps fund the ongoing development of Macro Deck. About the license

Web Client or Companion App?

Both let you control Macro Deck. Choose the experience that works best for you.

FeatureWeb ClientFreeCompanion App7-day free trial · One-time purchase, lifetime access
Drawn natively, no browser in betweenNoticeably better performance, especially on older phones and tablets
Fills the screen, no browser barsWeb client: where the browser supports it, usually once installed as a web app
Intuitive gesturesSwipe between folders, profiles and connected hosts
Finds your computers on the network
Connects over USBWeb client: Android only, with USB debugging
Actions and variables for the device, such as brightness or battery
Run scripts from widgets and automationsWidgets on both, Shortcuts and Siri on iOS, intents and Quick Settings tiles on Android
Turns the screen on and off automaticallyAndroid only: from actions and automations, or when the connection is lost and restored
Supports the active development of Macro Deck
View full feature comparison

Also by the Macro Deck developer

CountTogether App Icon

CountTogether

CountTogether is the innovative counter app for iOS and Android without complicated email registration. Create shared counters with friends and family in real-time. Useful for challenges, habits and shared goals.

WebsiteApp StoreGoogle Play