Stream Deck para gráficos do OBS: um botão para cada gráfico

O plugin do OBS para Stream Deck troca de cena e esconde fontes, mas não consegue mudar o que um gráfico diz. Este guia configura teclas que conseguem: uma tarja com nome, um gol do time da casa, o cronômetro da partida, o próximo item do roteiro — cada um com um único toque, e cada tecla mostrando se o seu gráfico está no ar.

Trocar de cena ou controlar gráficos

Quase todo mundo começa ligando e desligando a visibilidade de uma fonte de imagem pelo Stream Deck. Funciona até o gráfico precisar de outras palavras: um convidado novo, outro placar, uma manchete diferente. Você acaba com uma fonte para cada variação e um deck cheio de botões que parecem todos iguais.

Um motor de gráficos inverte essa lógica. O OBS fica com um único browser source transparente, e os botões falam com o motor de gráficos em vez de falar com o OBS. A tecla diz coloca a tarja ou casa +1; o motor cuida da animação e do texto. O OBS nem fica sabendo.

O que você precisa

O CueFinch rodando no PC da live, com a página de saída adicionada ao OBS como browser source (como adicionar).
Um Stream Deck (qualquer modelo, inclusive o Stream Deck Mobile) e o app gratuito Stream Deck da Elgato, versão 7.1 ou mais recente (Windows 10+ ou macOS 12+).
O plugin do CueFinch para Stream Deck — baixe em Prep → Connections (Preparação → Conexões), dentro do app.

Configuração passo a passo

No CueFinch abra Prep → Connections (Preparação → Conexões) e clique em Generate key and turn on (gerar chave e ativar). Isso liga a API HTTP local que os botões usam; sem chave ela fica desligada.
No cartão Stream Deck plugin, clique em Download the plugin (baixar o plugin) e dê um duplo clique no arquivo CueFinch.streamDeckPlugin. O app Stream Deck instala o plugin e uma categoria CueFinch aparece na lista de ações.
Arraste qualquer ação do CueFinch para uma tecla. No quadro Connection (conexão), no topo das configurações, digite o endereço do servidor — http://localhost:5275 quando o Stream Deck e o CueFinch estão no mesmo PC; para outro PC basta o endereço de rede dele, a porta é adicionada automaticamente — e cole a chave da API. Clique em Test connection (testar conexão) para conferir. Você só faz isso uma vez; todas as outras teclas reaproveitam esses dados.
Escolha o que a tecla faz: colocar ou tirar um gráfico do ar, mudar o placar, controlar o cronômetro, disparar um evento da partida, avançar no roteiro ou tirar tudo do ar.
Abra a página Live (ao vivo) do CueFinch e deixe-a aberta durante a transmissão. É ela que executa os toques nos botões, exatamente como se você tivesse clicado nos botões dela.

Um layout de deck que funciona numa partida

Quinze teclas bastam para uma live completa de narração de futebol. Um layout que se sustenta:

Linha de cima: placar liga/desliga · cronômetro da partida inicia/para · escalação · tirar tudo do ar.
Linha do meio: gol da casa · gol do visitante · casa −1 · visitante −1 (para o gol anulado).
Linha de baixo: cartão amarelo · cartão vermelho · substituição · tarja com nome · próximo item do roteiro.

Deixe o tirar tudo do ar num canto, longe das teclas que você aperta sob pressão. Ele remove todos os gráficos de uma vez — exatamente o que você quer numa emergência e exatamente o que você não quer por acidente.

Teclas que mostram o que está no ar

O plugin pergunta o tempo todo ao CueFinch o que está na tela. No Stream Deck +, os botões giratórios mudam o placar: gire para um gol de cada vez, aperte para aplicar o passo configurado. Uma tecla de gráfico fica vermelha enquanto o gráfico está no ar, a tecla do placar mostra o placar ao vivo e a do cronômetro mostra o tempo correndo. Quando você olha para baixo no meio da frase, o deck mostra o estado da transmissão, não apenas quais botões existem.

Se o CueFinch estiver fechado, a página Live não estiver aberta ou a chave estiver errada, a tecla mostra um alerta em vez de simplesmente não fazer nada.

Bitfocus Companion e outros controladores

Cada ação também é um endereço web comum, então qualquer coisa capaz de enviar uma requisição HTTP pode controlar os gráficos. No Bitfocus Companion, adicione uma conexão Generic HTTP e dê a um botão uma ação GET como http://localhost:5275/api/v1/object/score/toggle, com a chave num cabeçalho X-Api-Key (ou ?key= na URL). É o caminho mais comum em estúdios onde o Companion já controla um switcher ATEM.

Não tem Stream Deck? O controle remoto para celular e tablet que já vem no app oferece os mesmos botões numa tela sensível ao toque.

Problemas e soluções

As teclas mostram “NO LINK” (sem conexão). Abra o endereço do servidor num navegador no mesmo PC. Se nada carregar, o CueFinch não está rodando ou usa outra porta.
“PANEL CLOSED” (painel fechado). A página Live não está aberta. Abra-a no navegador e deixe a aba aberta.
“WRONG KEY” (chave errada). A chave da API foi gerada de novo. Cole a nova chave nas configurações de qualquer tecla do CueFinch.
O Stream Deck está em outro PC. Use o endereço de rede do PC da live em vez de localhost (ele aparece em Prep → Connections) e libere a porta 5275 no Firewall do Windows para redes privadas.

Seus gráficos na ponta dos dedos. Baixe o beta grátis, gere uma chave da API e configure sua primeira tecla em poucos minutos.

Baixe o beta grátis

Perguntas frequentes

O Stream Deck consegue mudar o texto de um gráfico do OBS?

Só com o plugin do OBS, não — ele apenas mostra, esconde e troca de cena. Com um motor de gráficos por trás do browser source, uma tecla pode mudar o placar, colocar outra tarja com nome ou iniciar um cronômetro, porque a tecla fala com o motor, não com o OBS.

Preciso de internet para o plugin do Stream Deck?

Não. O plugin fala com o CueFinch no seu próprio PC ou na sua rede local. Nada passa por um serviço na nuvem.

Funciona com o Stream Deck Mobile?

Sim. O Stream Deck Mobile roda os mesmos plugins que o hardware. Você também pode usar o controle remoto para celular do próprio CueFinch, que não precisa de nenhum app extra.

Posso usar o Bitfocus Companion no lugar?

Sim. Cada ação é um endereço HTTP, então o módulo Generic HTTP do Companion consegue dispará-la. Muitos estúdios usam o Companion para controlar os gráficos e um switcher ATEM pelo mesmo botão.