Benvenuti, matricole della RWTH: la vostra guida introduttiva allo Stream Deck Neo

Se stai leggendo questo messaggio, significa che hai appena ricevuto uno Stream Deck Neo durante l’evento di benvenuto organizzato dalla Fachschaft Elektrotechnik presso la RWTH di Aquisgrana. È tutto tuo. Questa guida illustra le due cose che vale la pena fare con questo dispositivo: configurarlo sul tuo portatile in circa cinque minuti e, se vuoi andare oltre, creare un’applicazione e pubblicarla su Elgato Marketplace, dove chiunque potrà installarla.

Stream Deck Neo è un piccolo controller che si posiziona accanto alla tastiera. È dotato di otto tasti LCD, due Touch Point per passare da una pagina all’altra dei tasti e una barra informativa LCD al centro che può visualizzare l’ora, il carico della CPU o il prossimo appuntamento in calendario.

Ogni tasto corrisponde a una schermata dedicata, così puoi sempre vedere a cosa serve e sei tu a decidere quale funzione assegnargli. Un tasto può aprire un’app, eseguire un comando, disattivare il microfono o attivare una sequenza che combina tutte e tre le operazioni. Si collega tramite USB-C e viene alimentato da quella stessa connessione: non ha né batteria né alimentatore.

Stream Deck è nato nel 2017 nel mondo dello streaming live e da allora si è evoluto. Sulla scrivania di uno studente, è una sorta di pannello di scorciatoie per i software che già utilizzi.

Ti serviranno: un portatile o un computer fisso con Windows 11 o versioni successive, oppure macOS 13 o versioni successive, e una porta USB-C libera. Usi Linux? Troverai una risposta a questa domanda alla fine di questo articolo.

1. Installa il software Stream Deck

Scarica Stream Deck per Windows o macOS. È gratuito ed è proprio questo programma che ti permette di personalizzare i tasti in base alle tue esigenze.

2. Collegalo alla presa di corrente

Basta collegare un cavo USB-C al computer. I tasti si illuminano e il software rileva automaticamente il dispositivo. Non è necessario effettuare alcuna procedura di accoppiamento né creare un account.

3. Carica il tuo profilo FSET della RWTH

Non è necessario partire da un dispositivo vuoto. Abbiamo creato un profilo per questa attivazione, quindi le chiavi sono già pronte all’uso.

Scarica il profilo FSET della RWTH — quindi fai doppio clic sul file e Stream Deck lo installerà.

In questa guida c'è tutto: la documentazione dell'SDK, gli esempi di plugin, il canale Discord di Maker, il Marketplace e dove trovare assistenza. Basta premere un tasto alla volta, direttamente dal dispositivo. È un punto di partenza, non uno schema fisso. Ogni tasto può essere modificato, rinominato o eliminato.

4. Personalizzalo

L'aggiunta dei propri tasti funziona allo stesso modo. Il pannello a destra del software elenca tutte le azioni che un tasto può eseguire: aprire un sito web, avviare un'applicazione, attivare un tasto di scelta rapida, avviare un timer, eseguire un comando. Basta trascinarne una su un tasto, configurarla nel pannello sottostante e premere il tasto. Il funzionamento è proprio questo. Per una guida completa, consulta la Guida rapida di Stream Deck.

Otto tasti possono sembrare pochi. Ma non lo sono, per due motivi: i Touch Points consentono di passare da una pagina all’altra e i profili possono cambiare automaticamente quando si passa da un’applicazione all’altra. Alcuni spunti di partenza per una laurea in ingegneria:

• Programmazione. Creare, eseguire, testare, salvare. A Multi-Action concatena diverse operazioni in un unico tasto, quindi salvare, compilare ed eseguire richiede una sola pressione invece di tre.
• Lezioni. Avvia la registrazione, apri le diapositive, inserisci un indicatore temporale sul punto che non hai seguito, avvia un conto alla rovescia prima del blocco successivo.
• Esercitazioni di laboratorio e lavori di progetto. Eseguire uno script di misurazione, aprire il log, passare da uno strumento all’altro su un computer condiviso.
• Chiamate di gruppo. Disattiva audio, attiva la videocamera, condividi lo schermo, esci senza dover prima cercare la finestra giusta.

Una volta che avrai trovato una struttura adatta a uno di questi, avrai creato un profilo. Ed è qui che inizia la parte interessante.

Un profilo è una configurazione dei tasti salvata: quali azioni sono associate a quali tasti, con le relative icone e impostazioni. Puoi averne uno per l'editor, uno per le lezioni, uno per le chiamate e fare in modo che Stream Deck passi automaticamente da uno all'altro in base all'app attiva.

Ne hai già uno: il profilo RWTH del passaggio 3. Aprilo nel software e potrai vedere esattamente come è strutturato. Quale azione è associata a quale tasto, come è configurata ciascuna di esse. Analizzare un profilo che funziona già è il modo più veloce per capire cosa puoi creare.

I profili vengono esportati in un unico file, che può essere condiviso con amici o compagni di classe. Tale file può anche essere pubblicato su Elgato Marketplace: ciò significa che un layout creato per un determinato software di laboratorio o una specifica catena di strumenti potrà essere installato da chiunque utilizzi lo stesso software o la stessa catena di strumenti.

Questo è il metodo più semplice per passare dall'utilizzo di Stream Deck alla pubblicazione dei contenuti. Non richiede alcuna conoscenza di programmazione.

Ricorda: non si tratta solo di Stream Deck Neo, ma di un intero ecosistema Stream Deck su più dispositivi. Ti consigliamo di dare un’occhiata alla sezione “Esplora Stream Deck” per una rapida panoramica prima di passare alla scoperta di ciò che puoi fare con l’SDK.

Tutto ciò che Stream Deck fa oltre alle azioni integrate, lo fa tramite plugin; l’SDK per scriverli è pubblico e documentato all’indirizzo docs.elgato.com/sdk. Una cosa va chiarita fin da subito: i plugin sono scritti in TypeScript e girano su Node.js, non in C e C++, linguaggi con cui state per trascorrere il vostro primo semestre. Se non avete mai avuto a che fare con nessuno dei due, il divario da colmare è più un fine settimana che un semestre, e TypeScript è comunque il linguaggio in cui è scritta la maggior parte degli strumenti che utilizzate quotidianamente. Arrivare a un plugin funzionante richiede poco tempo:

1. Installa Node.js, versione 24 o successiva.
2. Installa la CLI di Stream Deck da npm.
3. Esegui il comando `streamdeck create`. La procedura guidata crea una struttura di base per un plugin completo e funzionante.
4. Esegui il comando `npm run watch` e apporta le modifiche. Le modifiche verranno ricaricate automaticamente sul dispositivo finché questo rimane collegato.

A questo punto, gli esempi di plugin disponibili su GitHub sono plugin completi e funzionanti che puoi clonare, eseguire e analizzare. Questi sono alcuni esempi per aiutarti a muovere i primi passi. La documentazione ti sarà utile man mano che approfondirai l'argomento.

Elgato Marketplace è la piattaforma su cui vengono distribuiti plugin, profili, icone, salvaschermi e soundboard per Stream Deck. Pubblicare su questa piattaforma è ciò che ti rende un Elgato Maker. La configurazione prevede tre passaggi, da eseguire una sola volta:

1. Accedi alla Maker Console e crea la tua organizzazione.
2. Firma il Contratto del Creatore.
3. Invia il tuo prodotto. Ogni prodotto viene sottoposto a una verifica prima di essere pubblicato.

Sei tu a stabilire il prezzo e puoi pubblicare gratuitamente. Per i prodotti a pagamento, la ripartizione dei ricavi è 70/30: tu trattieni il 70%, mentre Elgato trattiene il 30%; i pagamenti vengono gestiti tramite Stripe Connect. I prodotti gratuiti non hanno restrizioni per paese. Tutti i dettagli sono riportati nella documentazione di Maker.

Crea un’applicazione per Stream Deck e pubblicala su Elgato Marketplace. È possibile inviare le candidature fino al 1° dicembre 2027.

Il miglior progetto presentato da uno studente della RWTH vince 1.000 € — in contanti o in prodotti Elgato, a tua scelta.

1. Realizzalo

Un profilo è la scorciatoia per iniziare: una configurazione dei tasti per un’attività specifica, esportata e condivisa. Un plugin è più semplice di quanto sembri: l’SDK è aperto, documentato e su GitHub sono disponibili esempi realizzati da altri utenti.

2. Pubblicalo

Invia il tuo progetto su Elgato Marketplace. È proprio in quel momento che diventerai un Elgato Maker.

3. Dicci che è tuo

Invia il link al Marketplace in modo che possiamo sapere che proviene dalla RWTH.

Scadenza: 1° dicembre 2027

Inizia con l'SDK

Termini e condizioni del concorso

• Maker Discord — le persone che sviluppano plugin e profili per lavoro e rispondono alle domande. Il modo più veloce per sbloccare la situazione.
• Documentazione per gli autori — tutto ciò che è possibile pubblicare e come funziona l'invio dei contenuti.
• Newsletter per maker — Novità sugli SDK, aggiornamenti sui moduli e sulle realizzazioni degli altri maker. Stiamo preparando qualcosa di specifico per gli studenti maker; la newsletter sarà il primo canale in cui verrà annunciato.