Sistema
Incluída no Macro DeckControle o computador pelo seu deck: apps, volume, comandos, notificações, suspensão e desligamento.
A página da integração Sistema com a chave ativada e sem opções de configuração
- Inicie, coloque em foco ou feche aplicativos, arquivos, pastas e sites
- Volume e silenciamento do dispositivo de áudio padrão ou de qualquer outro
- Execute comandos e salve a saída deles em uma variável
- Bloqueie, suspenda, hiberne, reinicie ou desligue
- CPU, RAM, GPU, disco, horário e app em foco como variáveis
A integração Sistema controla o computador em que o Macro Deck está rodando. Ela vem com o Macro Deck, já está ativada desde o início e não precisa de configuração, no Windows, macOS e Linux.
O que dá para fazer
- Apps, arquivos e sites: Iniciar aplicativo inicia um app, e o Modo dele também pode trazer para a frente um app já aberto (Iniciar ou focar) ou fechá-lo ao pressionar de novo (Alternar iniciar / parar). Abrir arquivo, Abrir pasta e Abrir site abrem as coisas com o app padrão. Encerrar aplicativo encerra um processo pelo nome.
- Áudio: Aumentar volume, Diminuir volume, Definir volume e Silenciar / reativar som funcionam na saída padrão, na entrada padrão ou em um dispositivo específico. Um botão com Silenciar / reativar som mostra se o dispositivo está silenciado.
- Comandos: Executar comando executa uma linha de comando no shell padrão, no PowerShell ou no Bash e pode salvar o que ela imprime em uma variável.
- Notificações: Enviar notificação mostra uma notificação do sistema operacional. Mostrar notificação do Macro Deck mostra uma mensagem dentro do Macro Deck em todas as telas conectadas.
- Energia: Bloquear computador, Suspender, Hibernar, Reiniciar e Desligar.
Variáveis
A integração informa o estado do computador como variáveis: uso de CPU, RAM e GPU, tamanho, espaço livre e atividade de cada disco, volume e silenciamento de cada alto-falante e microfone, data e hora, nome do computador e sistema operacional, se a tela está bloqueada e o aplicativo em primeiro plano. Mostre-as em rótulos, faça gráficos com um widget Gráfico de histórico ou Medidores, ou reaja a elas em automações.
Exemplos de uso
- Um botão de microfone com Silenciar / reativar som no microfone do headset que mostra se ele está silenciado.
- Um controle deslizante vinculado a
system_volume_percentque define o volume dos alto-falantes. - Um widget Medidores com
system_cpu_usage_percent,system_ram_usage_percentesystem_gpu_0_usage_percent. - Um botão que executa Iniciar aplicativo com Iniciar ou focar para o seu player de música.
- Um botão de "boa noite" que executa Bloquear computador, ou Desligar depois de um Aguardar.
- Um fluxo que executa Executar comando com um script e grava o resultado em uma variável mostrada no botão.
Novos dispositivos de áudio e discos recebem as suas variáveis poucos segundos depois de conectados.
O que é necessário
- Macro Deck 3 no Windows, macOS ou Linux
- No Linux: pactl ou amixer para o volume, notify-send para as notificações, systemd para as ações de energia
- No Linux, o uso da GPU exige o driver amdgpu ou o nvidia-smi
- No macOS, permissão para o Macro Deck controlar o System Events para Reiniciar e Desligar
Configuração
Passo 1: Confira se a integração está ativada
No Macro Deck, clique em Integrações na barra lateral e depois em Sistema. A chave no canto superior direito vem ativada por padrão; ative-a se estiver desativada. Não há nada para configurar: a aba Visão geral mostra Nenhuma opção de configuração disponível para esta integração. Se faltar algo no computador, por exemplo um backend de volume no Linux, a página lista isso como problema.
Passo 2: Adicione uma ação do Sistema a um botão
Na página Deck, clique em um botão. O deck precisa estar desbloqueado: se o botão Bloquear aparece no canto superior direito, ele está. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione Sistema à esquerda da caixa de diálogo Adicionar ação e escolha uma ação, por exemplo Silenciar / reativar som ou Iniciar aplicativo.
Passo 3: Preencha a ação
Cada ação pede só o que precisa:
- Iniciar aplicativo: o Aplicativo, Argumentos e Pasta de trabalho opcionais, e o Modo.
- Ações de volume: o Dispositivo de áudio e a Quantidade (%) ou o Volume (%).
- Executar comando: o Shell e o Comando, opcionalmente Salvar saída em variável.
Passo 4: Mostre um valor no botão
Para mostrar um valor, digite uma variável no rótulo do botão, por exemplo
CPU {{ vars.system_cpu_usage_percent }} %. A aba Variáveis da página do Sistema lista todas as variáveis do Sistema com o valor atual.Passo 5: Pressione o botão
Salve e pressione o botão, ou clique em Executar no editor para testar as ações na hora.
Ações17
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Iniciar aplicativo
- Inicia um aplicativo, ou alterna ou coloca em foco uma instância em execução.
- Abrir site
- Abre um site no navegador padrão.
- Abrir arquivo
- Abre um arquivo com o aplicativo padrão.
- Abrir pasta
- Abre uma pasta no gerenciador de arquivos do sistema.
- Encerrar aplicativo
- Encerra um processo em execução pelo nome, com a opção de antes pedir que ele feche a janela.
- Aumentar volume
- Aumenta o volume do dispositivo de áudio selecionado.
- Diminuir volume
- Diminui o volume do dispositivo de áudio selecionado.
- Silenciar / reativar som
- Alterna o silenciamento do dispositivo de áudio selecionado e mostra o estado no botão.
- Definir volume
- Define o volume do dispositivo de áudio selecionado em um nível específico.
- Enviar notificação
- Mostra uma notificação nativa do sistema operacional.
- Mostrar notificação do Macro Deck
- Mostra uma mensagem no Macro Deck nos dispositivos e apps conectados, como mensagem curta ou como caixa de diálogo.
- Executar comando
- Executa uma linha de comando no shell selecionado e pode salvar a saída em uma variável.
- Bloquear computador
- Bloqueia a tela, para que seja preciso a senha ou o PIN para voltar.
- Suspender
- Coloca o computador em suspensão.
- Hibernar
- Salva a sessão no disco e desliga totalmente (Windows e Linux).
- Reiniciar
- Reinicia o computador, com Forçar para ignorar apps que impediriam isso.
- Desligar
- Desliga o computador, com Forçar para ignorar apps que impediriam isso.
Variáveis12
Mostre estes valores em botões e widgets ou use-os em condições.
system_volume_percent,system_muted- Volume em porcentagem e silenciamento do dispositivo de saída padrão.
system_input_volume_percent,system_input_muted- Volume em porcentagem e silenciamento do dispositivo de entrada padrão.
system_audio_output_<device>_*,system_audio_input_<device>_*- Volume em porcentagem (
_volume_percent) e silenciamento (_muted) de cada alto-falante e microfone, por exemplosystem_audio_input_usb_mic_muted. system_cpu_usage_percent,system_cpu_name- Carga do processador em porcentagem e o modelo do processador.
system_ram_usage_percent,system_ram_used_gb,system_ram_total_gb- Memória em uso em porcentagem, memória usada e memória total em GB.
system_gpu_<n>_usage_percent,system_gpu_<n>_name- Carga em porcentagem e nome de cada placa de vídeo, numeradas a partir de
0, até oito placas. system_disk_<n>_*- Nome, ponto de montagem, sistema de arquivos, tamanho, espaço usado e livre, uso, velocidade de leitura e gravação e atividade de cada disco, numerados a partir de
0, até oito discos. system_date,system_time,system_datetime- A data, a hora e a data e hora atuais como texto.
system_timestamp_unix,system_day_of_week,system_hour,system_minute- Partes do horário atual: o timestamp Unix, o dia da semana, a hora e o minuto.
system_pc_name,system_os- O nome do computador e o sistema operacional.
system_locked- Se o computador está bloqueado (Windows e macOS).
system_focused_app,system_focused_app_path,system_focused_app_bundle_id- O aplicativo em primeiro plano, com o caminho e o bundle ID dele.
Perguntas frequentes
Posso controlar o volume de um dispositivo específico?
Sim. Toda ação de volume tem um campo Dispositivo de áudio com a saída padrão, a entrada padrão e todos os dispositivos que o Macro Deck já viu. Um dispositivo desconectado continua na lista, e as variáveis dele ficam indisponíveis até ele voltar.
Posso ajustar o volume com um controle deslizante?
Sim. Vincule um controle deslizante a uma variável de volume como system_volume_percent. Também é possível definir variáveis de volume e de silenciamento com Definir variável. Para ativar e desativar o silenciamento com um único botão, use Silenciar / reativar som.
Por que Reiniciar ou Desligar falha no macOS?
O macOS pede permissão antes. Permita o Macro Deck em Ajustes do Sistema > Privacidade e Segurança > Automação > System Events. Forçar não tem efeito no macOS, e o macOS não tem Hibernar.
Por que faltam volume, notificações ou as ações de energia no Linux?
Elas precisam de ferramentas que algumas distribuições não instalam: pactl (PulseAudio ou PipeWire) ou amixer para o volume, notify-send para as notificações e systemctl ou loginctl para as ações de energia. A página Sistema em Integrações lista o que falta.
Quanto tempo Executar comando espera?
Até o Tempo limite (segundos), 30 por padrão, e 0 espera até o comando terminar. Um comando que ainda estiver rodando depois disso continua rodando, a menos que a saída dele seja salva em uma variável.
Meus botões do Windows Utils do Macro Deck 2 são migrados?
A maioria. Ao migrar do Macro Deck 2, ações como iniciar aplicativo, abrir arquivo ou pasta, linha de comando e volume viram ações do Sistema, e teclas de atalho e texto digitado viram ações de Teclado.
Mais em Seu computador
Teclado
Incluída no Macro DeckPressione atalhos, digite texto e execute sequências de teclas no computador a partir de um botão.
Mouse
Incluída no Macro DeckClique, mova o ponteiro, arraste e role no computador a partir de um botão.
ADB / Android Debug Bridge
Incluída no Macro DeckControle um celular ou tablet Android via USB ou Wi-Fi: acorde o aparelho, inicie apps, toque, digite e capture a tela.
Steam
Incluída no Macro DeckInicie e feche jogos da Steam e mostre no deck o que você está jogando, seus amigos e sua biblioteca.