Bem-vindos, caloiros da RWTH: O vosso guia de introdução ao Stream Deck Neo

Se estás a ler isto, é porque acabaste de receber um Stream Deck Neo no evento de boas-vindas da Fachschaft Elektrotechnik na RWTH Aachen. Podes ficar com ele. Este guia aborda as duas coisas que vale a pena fazer com ele: pô-lo a funcionar no teu portátil em cerca de cinco minutos e, se quiseres ir mais além, criar algo para ele e publicá-lo no Elgato Marketplace, onde qualquer pessoa o pode instalar.

O Stream Deck Neo é um pequeno controlador que se coloca ao lado do teclado. Possui oito teclas LCD, dois «Touch Points» para alternar entre páginas de teclas e uma barra de informações LCD no meio, que pode mostrar a hora, a carga da CPU ou o próximo compromisso na agenda.

Cada tecla corresponde a um ecrã próprio, pelo que vê sempre o que ela faz e é o utilizador a decidir qual é essa função. Uma tecla pode abrir uma aplicação, executar um comando, silenciar o microfone ou acionar uma sequência que inclua as três ações. Liga-se através de USB-C e é alimentada por essa ligação; não tem bateria nem adaptador de corrente.

O Stream Deck surgiu no âmbito das transmissões ao vivo em 2017 e tem vindo a evoluir desde então. Numa secretária de estudante, funciona como uma caixa de atalhos para o software que já utilizas.

É necessário: um portátil ou computador de secretária com o Windows 11 ou uma versão posterior, ou o macOS 13 ou uma versão posterior, e uma porta USB-C livre. Utiliza o Linux? Há uma pergunta sobre isso no final deste artigo.

1. Instale o software do Stream Deck

Descarregue o Stream Deck para Windows ou macOS. É gratuito e é a aplicação que permite configurar as teclas para o que precisar.

2. Ligue-o à tomada

Basta ligar um cabo USB-C ao seu computador. As teclas acendem-se e o software deteta o dispositivo automaticamente. Não é necessário efetuar qualquer emparelhamento nem criar uma conta.

3. Carregue o seu perfil FSET da RWTH

Não é necessário começar com um dispositivo vazio. Criámos um perfil para esta ativação, pelo que as chaves já vêm prontas a usar.

Descarregue o perfil FSET da RWTH — depois, clique duas vezes no ficheiro e o Stream Deck irá instalá-lo.

Tudo o que é necessário está neste guia: a documentação do SDK, os exemplos de plugins, o Discord do Maker, o Marketplace e onde obter ajuda. Basta premir uma vez em cada um, diretamente a partir do dispositivo. Trata-se de um ponto de partida, não de um layout fixo. Cada tecla pode ser alterada, renomeada ou eliminada.

4. Dá-lhe o teu toque pessoal

Adicionar as suas próprias teclas funciona da mesma forma. O painel do lado direito do software apresenta tudo o que uma tecla pode fazer: abrir um site, iniciar uma aplicação, ativar uma tecla de atalho, iniciar um temporizador, executar um comando. Arraste uma dessas opções para uma tecla, configure-a no painel abaixo e prima a tecla. É assim que funciona. Para um guia passo a passo completo, consulte o Guia de Início Rápido do Stream Deck.

Oito teclas pode parecer pouco. Mas não é, por duas razões: os «Touch Points» permitem-lhe alternar entre páginas e os perfis podem mudar automaticamente quando muda de aplicação. Alguns pontos de partida para uma licenciatura em engenharia:

• Programação. Criar, executar, testar, submeter. A A função «Multi-Action» agrupa várias etapas numa única tecla, pelo que guardar, compilar e executar passam a ser feitos com um único toque, em vez de três.
• Aulas. Inicie uma gravação, abra os slides, marque o momento em que não acompanhou a explicação e inicie uma contagem decrescente antes do próximo bloco.
• Trabalhos de laboratório e de projeto. Executar um script de medição, abrir o registo, alternar entre as ferramentas numa máquina partilhada.
• Chamadas em grupo. Silenciar, ativar a câmara, partilhar o ecrã, sair sem ter de procurar primeiro a janela certa.

Assim que tiveres um layout que funcione para uma destas opções, já criaste um perfil. É aí que começa a parte interessante.

Um perfil é uma configuração de teclas guardada: quais ações estão associadas a quais teclas, com os respetivos ícones e definições. Podes ter um para o teu editor, outro para as aulas e outro para as chamadas, e fazer com que o Stream Deck alterne entre eles automaticamente, consoante a aplicação em foco.

Já tens um: o perfil RWTH do passo 3. Abre-o no software e poderás ver exatamente como está organizado. Que ação está associada a cada tecla, o que cada uma está configurada para fazer. Analisar um perfil que já funciona é a forma mais rápida de compreender o que podes criar.

Os perfis são exportados para um único ficheiro, que pode ser partilhado com amigos ou colegas de turma. Esse ficheiro também pode ser publicado no Elgato Marketplace, o que significa que um layout que criou para um software de laboratório específico ou para uma cadeia de ferramentas específica pode ser instalado por qualquer pessoa que utilize o mesmo software ou a mesma cadeia de ferramentas.

Este é o caminho mais simples, desde a utilização do Stream Deck até à publicação de conteúdos para o mesmo. Não é necessário escrever qualquer código.

Lembra-te de que não se trata apenas do Stream Deck Neo, mas de todo um ecossistema Stream Deck em vários dispositivos. É melhor consultares a secção «Explorar o Stream Deck» para teres uma visão geral rápida antes de começares a descobrir o que podes fazer com o SDK.

Tudo o que o Stream Deck faz para além das suas ações integradas, faz-se através de plugins, e o SDK para os criar é público e está documentado em docs.elgato.com/sdk. Uma coisa que é importante esclarecer desde já: os plugins são escritos em TypeScript, executados no Node.js, e não em C e C++, com os quais estás prestes a passar o teu primeiro semestre. Se nunca tiveste contacto com nenhuma destas linguagens, a diferença de conhecimento é mais um fim de semana do que um semestre, e o TypeScript é, de qualquer forma, a linguagem em que a maioria das ferramentas à tua volta está escrita. Chegar a um plugin funcional é rápido:

1. Instale o Node.js, versão 24 ou superior.
2. Instale a CLI do Stream Deck a partir do npm.
3. Execute o comando «streamdeck create». O assistente cria uma estrutura para um plugin completo e funcional.
4. Execute o comando «npm run watch» e faça as alterações. As alterações são recarregadas automaticamente no dispositivo enquanto este estiver ligado.

A partir daí, os exemplos de plugins no GitHub são plugins completos e funcionais que pode clonar, executar e analisar. Estes são alguns exemplos para o ajudar a dar os primeiros passos. A documentação será importante à medida que for aprofundando os seus conhecimentos.

O Elgato Marketplace é o local onde são distribuídos os plugins, perfis, ícones, protetores de ecrã e placas de som do Stream Deck. Publicar nele é o que faz de si um Elgato Maker. A configuração é feita em três passos, que se realizam uma única vez:

1. Aceda à Consola do Maker e crie a sua organização.
2. Assine o Acordo do Criador.
3. Envie o seu produto. Tudo passa por um processo de revisão antes de ser publicado.

É o utilizador que define o seu próprio preço e pode publicar gratuitamente. Os produtos pagos seguem uma repartição de 70/30. O utilizador fica com 70% e a Elgato fica com 30%, sendo os pagamentos processados através do Stripe Connect. Os produtos gratuitos não têm restrições por país. Todos os detalhes encontram-se na documentação do Maker.

• Discord dos criadores — as pessoas que criam plugins e perfis profissionalmente, respondendo a perguntas. O sítio mais rápido para resolver os teus problemas.
• Documentação do Maker — tudo o que pode publicar e como funciona o envio.
• Boletim informativo para criadores — Lançamentos de SDK, novidades sobre formulários e o que outros criadores lançaram. Estamos a planear algo especificamente para estudantes criadores; a newsletter será o primeiro local onde isso será anunciado.