Welkom, eerstejaarsstudenten van de RWTH: jullie Stream Deck Neo-startgids

Als je dit leest, heb je zojuist een Stream Deck Neo meegenomen van het welkomstfeest van de Fachschaft Elektrotechnik aan de RWTH Aachen. Je mag het houden. In deze handleiding worden de twee dingen beschreven die de moeite waard zijn om ermee te doen: het apparaat in ongeveer vijf minuten op je laptop aan de praat krijgen, en – als je een stapje verder wilt gaan – iets voor het apparaat bouwen en dit publiceren op de Elgato Marketplace, waar iedereen het kan installeren.

De Stream Deck Neo is een kleine controller die naast je toetsenbord wordt geplaatst. Hij heeft acht LCD-toetsen, twee Touch Points om tussen pagina’s met toetsen te schakelen, en een LCD-infobalk in het midden waarop de tijd, je CPU-belasting of de volgende afspraak in je agenda kan worden weergegeven.

Elke toets heeft zijn eigen scherm, zodat je altijd ziet wat hij doet, en jij bepaalt zelf wat dat is. Een toets kan een app openen, een commando uitvoeren, je microfoon dempen of een reeks van alle drie activeren. Het apparaat wordt aangesloten via USB-C en krijgt via die aansluiting stroom; er is geen batterij en geen stroomadapter nodig.

Stream Deck is in 2017 ontstaan vanuit de wereld van livestreaming en heeft zich sindsdien verder ontwikkeld. Op een studentenbureau fungeert het als een snelkoppelingsbox voor software die je al gebruikt.

Je hebt het volgende nodig: een laptop of desktop met Windows 11 of nieuwer, of macOS 13 of nieuwer, en een vrije USB-C-poort. Gebruik je Linux? Daarover staat een vraag aan het einde van dit artikel.

1. Installeer de Stream Deck-software

Download Stream Deck voor Windows of macOS. Het is gratis en zorgt ervoor dat je de toetsen kunt aanpassen aan wat je maar wilt.

2. Sluit het aan

Sluit één USB-C-kabel aan op je apparaat. De toetsen lichten op en de software herkent het apparaat automatisch. Je hoeft geen koppeling uit te voeren en er is geen account nodig.

3. Laad je RWTH FSET-profiel

Je hoeft niet met een leeg apparaat te beginnen. We hebben voor deze activering een profiel samengesteld, zodat de sleutels meteen klaar zijn voor gebruik.

Download het RWTH FSET-profiel — dubbelklik vervolgens op het bestand en Stream Deck installeert het.

Alles wat je nodig hebt, staat in deze handleiding: de SDK-documentatie, de voorbeeldplug-ins, de Maker Discord, de Marketplace en waar je hulp kunt krijgen. Eén druk op elke knop, rechtstreeks vanaf het apparaat. Het is een uitgangspunt, geen vaste indeling. Elke knop kan worden aangepast, hernoemd of verwijderd.

4. Maak er iets persoonlijks van

Het toevoegen van je eigen toetsen werkt op dezelfde manier. In het paneel aan de rechterkant van de software staat alles wat je met een toets kunt doen: een website openen, een applicatie starten, een sneltoets activeren, een timer starten, een commando uitvoeren. Sleep een actie naar een toets, stel deze in het paneel eronder in en druk op de toets. Dat is het hele principe. Raadpleeg de Stream Deck-snelstartgids voor een volledige uitleg.

Acht toetsen klinkt misschien als weinig. Dat is het echter niet, en wel om twee redenen: met de Touch Points kun je tussen pagina’s schakelen, en profielen kunnen automatisch wisselen wanneer je van applicatie wisselt. Enkele uitgangspunten voor een ingenieursopleiding:

• Coderen. Bouwen, uitvoeren, testen, committen. Een Multi-Action koppelt meerdere stappen aan één toets, zodat opslaan, bouwen en uitvoeren met één druk op de knop gebeurt in plaats van drie.
• Hoorcolleges. Start een opname, open de dia’s, plaats een tijdstempel bij het gedeelte dat je niet hebt kunnen volgen en start een aftelling voor het volgende deel.
• Lab- en projectwerk. Een meetscript starten, het logboek openen, schakelen tussen de tools op een gedeelde computer.
• Groepsgesprekken. Geluid dempen, camera inschakelen, scherm delen, het gesprek verlaten zonder eerst naar het juiste venster te hoeven zoeken.

Zodra je een lay-out hebt die voor een van deze opties werkt, heb je een profiel aangemaakt. En dan begint het pas echt interessant te worden.

Een profiel is een opgeslagen toetsindeling: welke acties aan welke toetsen zijn toegewezen, inclusief de bijbehorende pictogrammen en instellingen. Je kunt bijvoorbeeld één profiel gebruiken voor je tekstverwerker, één voor colleges en één voor telefoongesprekken, en Stream Deck automatisch tussen deze profielen laten schakelen op basis van de actieve app.

Je hebt er al één: het RWTH-profiel uit stap 3. Open het in de software en je kunt precies zien hoe het in elkaar zit. Welke actie aan welke toets is toegewezen, en wat elke toets doet. Het ontleden van een profiel dat al werkt, is de snelste manier om te begrijpen wat je kunt bouwen.

Profielen worden geëxporteerd naar één enkel bestand, dat je kunt delen met vrienden of klasgenoten. Dat bestand kan ook worden gepubliceerd op Elgato Marketplace, wat betekent dat een lay-out die je hebt gemaakt voor een specifieke laboratoriumsoftware of een specifieke toolchain kan worden geïnstalleerd door iedereen die hetzelfde gebruikt.

Dit is de eenvoudigste manier om Stream Deck te gebruiken en er content voor te publiceren. Je hebt er helemaal geen code voor nodig.

Vergeet niet dat het niet alleen om de Stream Deck Neo gaat, maar om een heel Stream Deck-ecosysteem op meerdere apparaten. Bekijk het beste eerst ‘Explore Stream Deck’ voor een kort overzicht, voordat je verdergaat met het ontdekken van de mogelijkheden van de SDK.

Alles wat Stream Deck doet buiten de ingebouwde acties om, gebeurt via plug-ins. De SDK om deze te schrijven is openbaar en gedocumenteerd op docs.elgato.com/sdk. Eén ding moet ik je meteen zeggen: plug-ins worden geschreven in TypeScript en draaien op Node.js, niet in C en C++ – de talen waarmee je je eerste semester gaat doorbrengen. Als je nog nooit met een van beide in aanraking bent gekomen, kost het je eerder een weekend dan een semester om de kloof te overbruggen, en TypeScript is sowieso de taal waarin de meeste tools om je heen zijn geschreven. Het is snel geregeld om een werkende plug-in te maken:

1. Installeer Node.js, versie 24 of hoger.
2. Installeer de Stream Deck CLI via npm.
3. Voer `streamdeck create` uit. De wizard zet een complete, werkende plug-in op.
4. Voer `npm run watch` uit en breng wijzigingen aan. Wijzigingen worden automatisch vernieuwd op het apparaat zolang het is aangesloten.

De voorbeelden van plug-ins op GitHub zijn complete, werkende plug-ins die je kunt klonen, uitvoeren en uitpluizen. Dit zijn enkele voorbeelden om je op weg te helpen. De documentatie zal van groot belang zijn naarmate je je er verder in verdiept.

Via de Elgato Marketplace worden Stream Deck-plug-ins, profielen, pictogrammen, screensavers en geluidsboards aangeboden. Door hier iets te publiceren, word je een Elgato Maker. De installatie bestaat uit drie stappen, die je slechts één keer hoeft uit te voeren:

1. Ga naar de Maker Console en maak je organisatie aan.
2. Onderteken de Maker-overeenkomst.
3. Dien je product in. Alles wordt eerst beoordeeld voordat het wordt geplaatst.

Je bepaalt zelf je prijs en je kunt gratis publiceren. Bij betaalde producten geldt een verdeling van 70/30. Jij houdt 70% en Elgato neemt 30%, waarbij de uitbetalingen via Stripe Connect verlopen. Voor gratis producten gelden geen landbeperkingen. De volledige details vind je in de Maker-documentatie.

• Maker Discord — de mensen die voor hun werk plug-ins en profielen maken en vragen beantwoorden. De snelste manier om weer op gang te komen.
• Documentatie voor makers — alles wat je kunt publiceren en hoe het indienen in zijn werk gaat.
• Maker-nieuwsbrief — SDK-releases, nieuws over formulieren en wat andere makers hebben uitgebracht. We hebben iets speciaals in petto voor student-makers; dit wordt als eerste in de nieuwsbrief aangekondigd.