Gratuito desde 2018, open source desde 2021

Por que Macro Deck?

O Macro Deck é mais do que uma alternativa ao Stream Deck. É uma plataforma de automação flexível e de código aberto, com uma longa história, uma comunidade ativa e um ecossistema que qualquer pessoa pode estender.

Transforme os celulares, tablets e navegadores que você já tem em uma central de controle personalizável para o seu computador e decida o que acontece por trás de cada botão.

Um deck em um tablet: player de música, relógio, previsão do tempo, controle deslizante de volume, gráfico de CPU e botões de ação coloridosO mesmo deck em um celular segurado na horizontal

Desde 2018

Uma das primeiras alternativas gratuitas ao Stream Deck

O Stream Deck da Elgato tornou comuns as teclas de macro dedicadas nas mesas de streamers. Em novembro de 2018, o Macro Deck apareceu no fórum do OBS com outra ideia: um macro pad gratuito e sem anúncios que roda no dispositivo Android que você já tem.

Desde então, ele cresceu versão após versão, moldado por quem o usa, de pastas de atalhos a uma plataforma de automação multiplataforma.

Leia a publicação original no fórum do OBS
  1. Novembro de 2018

    A primeira versão

    Atalhos de teclado e de mídia, lançadores de aplicativos e pastas em um dispositivo Android, conectado a um PC por Wi-Fi.

    A janela do Macro Deck Server 1.1.6 Beta: uma grade de botões de macro, uma lista de ações à esquerda e o status da conexão e as pastas à direita
  2. Macro Deck 2

    Aberto a plugins

    Um aplicativo para Windows com plugins, que trouxe integrações como OBS Studio e Discord. O código-fonte foi aberto sob a licença Apache 2.0 em novembro de 2021.

    A janela do Macro Deck 2 com barra lateral, pastas e uma grade de botões com relógio, bateria do headset e microfone silenciado
  3. Macro Deck 3

    Uma plataforma

    Um host para Windows, macOS e Linux, um cliente web, apps nativos Companion, um SDK de plugins e uma Store revisada.

    O editor de decks do Macro Deck 3 com player de música, relógio, clima, controle de volume, gráfico de CPU e botões de ação coloridos

Automação

Lógica de verdade, não só atalhos

Um botão pode fazer mais do que enviar um atalho de teclado. As ações rodam como fluxos com condições, laços e esperas, reagem a valores em tempo real, e as automações as executam sem que ninguém aperte nada.

Go live

  1. PressToque curto no botão

  2. Ifstream_live é verdadeiro

    • Acionar o atalho de parada
    • Definir stream_live como falso
    • Deixar o botão vermelho
  3. Else ifA carga da CPU está acima de 85 e o Spotify está tocando

    • Enviar uma notificação em vez de iniciar a transmissão
  4. OtherwiseNada impede

    • Diminuir o volume do Spotify
    • Repetir 3 vezes: definir a borda como Piscar, aguardar 1 segundo
    • Acionar o atalho de início
    • Definir stream_live como verdadeiro
    • Deixar o botão verde
Um toque, três resultados. Este é o fluxo real por trás do botão, como ele aparece no editor.
O fluxo Go live no editor do Macro Deck: um bloco If / Else com um Else if que combina duas condições e um ramo Otherwise com um laço Repeat, um Wait, atalhos de teclado, variáveis e mudanças de cor
Condições e laços
If, Else if e Else com condições combinadas, Repeat e Wait.
Variáveis
Valores em tempo real do seu computador e das integrações, exibidos nos botões e usados em condições.
Eventos
Execute uma automação em um horário definido, quando um dispositivo se conectar, uma variável mudar ou o OBS começar a transmitir.
Estados do botão
Dê vários estados a um botão, cada um com sua própria aparência, ou faça-o acompanhar uma variável, como seu status de mudo no Discord.
Outros computadores
Com o Macro Deck Delegate, um botão executa um script em outro PC e importa as variáveis que ele compartilha.
Widgets em tempo real
Controles deslizantes, medidores, gráficos, players de música e widgets de chat mostram o que está acontecendo e respondem ao toque.

Útil muito além do streaming

Produtividade
Veja de relance sua próxima reunião e os e-mails não lidos, e troque para o seu perfil de trabalho em um horário definido.
Administração de sistemas
Acompanhe CPU e RAM em medidores, execute comandos e guarde a saída deles em uma variável, ou pause o AdGuard Home.
Automação residencial
Ligue luzes, execute cenas e mostre em botões os estados em tempo real do Home Assistant, refletindo o estado real.
Fluxos de trabalho personalizados
Chame qualquer API web com a integração HTTP ou execute scripts do AutoHotkey no Windows.

Store de plugins

Plugins da comunidade com origem rastreável

A Store dentro do Macro Deck oferece plugins mantidos pela comunidade. O que a diferencia é a forma como um plugin chega até ela: todos são compilados a partir de código-fonte público, revisados por uma pessoa e assinados antes de você poder instalá-los.

  1. Repositório público

    O código-fonte é público no GitHub, sob uma licença de código aberto. As dependências vêm de pacotes públicos do NuGet; bibliotecas de terceiros pré-compiladas e incluídas no pacote não são permitidas.

  2. Publicação confiável

    Uma versão com tag executa o fluxo de trabalho de lançamento do próprio Macro Deck. O GitHub confirma o repositório, o commit e o fluxo de trabalho, então um binário compilado em outro lugar não pode ser enviado, e os criadores não possuem token de publicação nem chave de assinatura.

  3. Revisão por IA e por pessoas

    Todo primeiro envio e toda atualização passam por verificações automáticas e análise assistida por IA, e depois seguem para um moderador humano, que toma a decisão. As revisões avaliam as diretrizes da Store, possíveis comportamentos maliciosos, problemas de segurança e dependências.

  4. Assinatura criptográfica

    Após a aprovação, o Creator Portal assina o pacote. O certificado dele se encadeia a uma chave raiz do Macro Deck mantida offline.

  5. Store oficial

    O pacote é publicado por meio de um registro assinado. O Macro Deck verifica a assinatura antes de instalá-lo e de novo toda vez que inicia o plugin.

O que você vê no Macro Deck

Uma assinatura válida mostra que um pacote passou por esse processo. Você ainda pode instalar plugins sem assinatura, por exemplo os seus próprios, mas a diferença continua visível.

  • AssinadoÉ instalado normalmente. Se os arquivos forem alterados depois, o plugin deixa de ser carregado.
  • Sem assinaturaO Macro Deck avisa você antes. Ele só é instalado depois que você confirmar, e o plugin continua marcado como não verificado.
  • Assinatura inválidaRecusado. Uma assinatura que não é verificada não pode ser confirmada manualmente.

Após a publicação

O Macro Deck continua verificando os repositórios dos plugins publicados. Um plugin cujo repositório se torna privado ou desaparece é retirado da lista após um prazo de 14 dias, e um certificado revogado bloqueia novas instalações e atualizações.

O que isso não pode prometer

Revisões e assinaturas reduzem o risco e estabelecem de onde um pacote veio. Elas não podem garantir que um plugin esteja livre de vulnerabilidades ou de código malicioso. Os plugins não rodam em sandbox: eles são executados com as permissões da sua conta de usuário, então trate a instalação de um deles como a de qualquer outro programa.

Propriedade

Roda no seu computador e não há assinatura

Local em primeiro lugar, sem precisar de conta

O Macro Deck roda no seu próprio computador, e seus dispositivos se conectam diretamente a ele. As funcionalidades principais não dependem dos serviços de nuvem do Macro Deck, e você não precisa de uma conta do Macro Deck para usá-lo.

  • Hospedado por você, na sua própria máquina
  • Sua configuração continua sob o seu controle
  • Nenhuma conta do Macro Deck necessária
  • Nenhum serviço de nuvem necessário para as funcionalidades principais
  • Host de código aberto sob a licença Apache 2.0

As contas são opcionais e adicionam serviços como manter uma licença do Companion na sua conta ou avaliar itens da Store.

Integrações com serviços online, como Spotify ou Twitch, ainda precisam de conexão com a internet, assim como a Store e a ativação de uma compra do Companion.

Quanto custa

Host do Macro DeckGrátisGratuito e de código aberto, para Windows, macOS e Linux.
Cliente webGrátisUma forma completa de usar seus decks em um navegador atual na sua rede, sem instalar nada.
Apps CompanionCompra únicaApps nativos para Android e iOS, de código fechado, com um teste gratuito de 7 dias em cada dispositivo.

Uma licença cobre as duas plataformas. Você a compra uma vez no app, ela não expira, e o Macro Deck a repassa aos seus outros dispositivos Android e iOS que se conectam ao seu computador.

Os apps desenham os decks de forma nativa, encontram seus computadores na rede e adicionam gestos, resposta háptica, USB sem depuração e ações para o próprio dispositivo. Seus decks têm a mesma aparência no cliente web.

Dispositivos

Use os dispositivos que você já tem

Um celular sobrando, um tablet antigo ou uma janela do navegador podem virar a sua central de controle, então não é preciso comprar hardware dedicado. Conecte vários ao mesmo tempo, cada um com seu próprio perfil e layout.

O aplicativo desktop do Macro Deck com seu editor de decksA tela Conexões do app Companion em um celular, com uma conexão USB e dois computadores salvos
Host do Macro DeckWindows, macOS e Linux
  • Cliente webQualquer navegador atual
  • AndroidApp Companion
  • iOSApp Companion
Pela sua rede
Os dispositivos se conectam diretamente ao seu computador. Os apps Companion o encontram para você; o cliente web abre a partir de um endereço ou de um QR code.
Por USB
O Android se conecta por ADB com o app Companion ou o cliente web. Os apps Companion no Android e no iOS também podem se conectar sem depuração USB, o que ainda é experimental.
Lado a lado
Use um celular para o chat e um tablet para as cenas. Dispositivos diferentes podem abrir perfis diferentes ao mesmo tempo.

Desenvolvedores

Crie a integração, não a infraestrutura

O SDK de plugins oferece os mesmos contratos que as integrações embutidas usam. Você escreve em C#, e o Macro Deck cuida de dispositivos, configurações, renderização e distribuição.

SDK de plugins
Pacotes .NET documentados para ações, variáveis, eventos, widgets, telas de configuração e provedores de dispositivos.
CLI
O macrodeck-plugin cria, executa, testa, valida e empacota um plugin sem precisar do Macro Deck instalado.
Creator Portal
Conecte seu repositório, gerencie builds, testadores e lançamentos e publique na Store.
APIs públicas
Consulte o status e as análises dos seus projetos pela API pública, para painéis, selos e CI.

E, quando quiser saber como algo funciona, o host é de código aberto.

~ % 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 % 

Macro Deck UI

Plugins podem trazer sua própria interface

Os plugins não se limitam a adicionar ações e variáveis. O Macro Deck tem seu próprio framework de interface declarativa para C#: você descreve uma view uma única vez como uma árvore de componentes, e o Macro Deck a renderiza onde for preciso, seja como widget de deck, tela de configuração, visualização de pasta ou caixa de diálogo modal.

var muted = new UiState<bool>(false);

var tile = new UiButton
{
    Key = "mute",
    Justify = UiComponentJustify.Center,
    Background = UiValue.From(() => muted.Value ? "#ff3b30" : "#2c2c2e"),
    Events = [UiEventHandler.On(UiComponentEvents.Press, () => muted.Value = !muted.Value)],
    Children = [new UiTextRun
    {
        Key = "label",
        Text = UiText.From(() => muted.Value ? "Muted" : "Mute"),
        Size = 0.14,
    }],
};

var view = new UiView(request.Surface, tile);
O widget do Macrogotchi: barras de status de comida, felicidade e energia, um bichinho azul de pixel art dormindo e seis botões abaixoO widget do Macrogotchi em um deck no editor do Macro Deck, ao lado de botões de ação
Macrogotchi, um widget desenhado inteiramente por um plugin.

O Macrogotchi mostra até onde isso vai. Este plugin de código aberto mantém um bichinho virtual no seu deck, com barras de status, um sprite de pixel art desenhado com células coloridas e seis botões, tudo em um único widget.

As views são montadas com componentes do Macro Deck UI, como stacks, grades, gráficos, medidores e controles deslizantes, e não com páginas web incorporadas, por isso combinam com o restante do seu deck.

Comunidade

Construído com a comunidade desde 2018

O Macro Deck existe porque as pessoas continuam usando, relatando o que está errado e criando o que falta. Muitas integrações da Store são mantidas pela comunidade, o host é desenvolvido no GitHub e o que vem a seguir é planejado em público.

Experimente em um dispositivo que você já tem

O Macro Deck e o seu cliente web são gratuitos para baixar e usar.

Elgato e Stream Deck são marcas registradas de seus respectivos proprietários. O Macro Deck é um projeto independente e não é afiliado nem endossado pela Elgato.