Velkommen, førsteårsstuderende ved RWTH: Jeres Startvejledning til Stream Deck Neo

Hvis du læser dette, har du netop hentet et Stream Deck Neo ved velkomstarrangementet hos Fachschaft Elektrotechnik på RWTH Aachen. Du må gerne beholde det. Denne vejledning beskriver de to ting, der er værd at gøre med det: at få det til at fungere på din bærbare computer på cirka fem minutter, og – hvis du vil gå et skridt videre – at udvikle noget til det og offentliggøre det på Elgato Marketplace, hvor alle kan installere det.

Stream Deck Neo er en lille controller, der placeres ved siden af dit tastatur. Den har otte LCD-taster, to Touch Points til at skifte mellem sider med taster og en LCD-infobar i midten, der kan vise klokkeslættet, din CPU-belastning eller den næste begivenhed i din kalender.

Hver tast udgør sin egen skærm, så du altid kan se, hvad den gør, og selv bestemme, hvad det skal være. En tast kan åbne en app, udføre en kommando, slå mikrofonen fra eller udløse en række af alle tre handlinger. Den tilsluttes via USB-C og får strøm via denne forbindelse – der er hverken batteri eller strømadapter.

Stream Deck opstod i forbindelse med livestreaming i 2017 og har udviklet sig siden da. På et studerendes skrivebord fungerer det som en genvejsboks til den software, man allerede bruger.

Du skal bruge: en bærbar eller stationær computer med Windows 11 eller nyere, eller macOS 13 eller nyere, samt en ledig USB-C-port. Bruger du Linux? Der er et spørgsmål om det i slutningen af denne artikel.

1. Installer Stream Deck-softwaren

Download Stream Deck til Windows eller macOS. Det er gratis, og det er den del, der gør, at tasterne kan bruges til lige præcis det, du har brug for.

2. Sæt stikket i stikkontakten

Et USB-C-kabel tilsluttes din computer. Tasterne lyser op, og softwaren genkender enheden automatisk. Der er ingen parring, og du behøver ikke oprette en konto.

3. Indlæs din RWTH FSET-profil

Du behøver ikke at starte med en tom enhed. Vi har oprettet en profil til denne aktivering, så nøglerne er klar til brug, når du modtager dem.

Download RWTH FSET-profilen — dobbeltklik derefter på filen, så installerer Stream Deck den.

Alt, hvad du har brug for, findes i denne vejledning: SDK-dokumentationen, eksempler på plugins, Maker Discord, Marketplace og hvor du kan få hjælp. Et enkelt tryk på hver, direkte fra enheden. Det er et udgangspunkt, ikke et fast layout. Hver eneste tast kan ændres, omdøbes eller fjernes.

4. Gør det til dit eget

Det fungerer på samme måde, når du tilføjer dine egne taster. I panelet til højre i programmet vises en oversigt over alt, hvad en tast kan bruges til: Åbne en hjemmeside, starte et program, udløse en genvejstast, starte en timer eller udføre en kommando. Træk en af disse funktioner over på en tast, konfigurer den i panelet nedenfor, og tryk på tasten. Det er hele princippet. Se Stream Deck-hurtigstartguiden for en fuldstændig gennemgang.

Otte taster lyder måske af lidt. Det er det dog ikke, af to grunde: Touch Points-tasterne skifter mellem siderne, og profilerne kan skifte automatisk, når du skifter mellem programmer. Her er nogle udgangspunkter for en ingeniøruddannelse:

• Programmering. Udvikle, køre, teste, committe. A Multi-Action kæder flere trin sammen til én tast, så gem, kompilér og kør bliver til ét tastetryk i stedet for tre.
• Forelæsninger. Start en optagelse, åbn diasene, sæt et tidsstempel på det sted, du ikke kunne følge med, og start en nedtælling inden næste afsnit.
• Laboratorie- og projektarbejde. Kør et måleskript, åbn logfilen, skift mellem værktøjerne på en fælles computer.
• Gruppesamtaler. Lydløs, kamera, skærmdeling, forlad uden først at skulle lede efter det rigtige vindue.

Når du har fundet et layout, der passer til en af disse, har du oprettet en profil. Og det er her, det bliver rigtig spændende.

En profil er et gemt tastaturlayout: hvilke handlinger der er knyttet til hvilke taster, sammen med deres ikoner og indstillinger. Du kan have én profil til din editor, én til forelæsninger og én til opkald, og lade Stream Deck skifte automatisk mellem dem afhængigt af, hvilken app der er aktiv.

Du har allerede en: RWTH-profilen fra trin 3. Åbn den i softwaren, så kan du se præcis, hvordan den er sammensat. Hvilken handling der er knyttet til hvilken tast, og hvad hver enkelt er indstillet til at gøre. At analysere en profil, der allerede fungerer, er den hurtigste måde at forstå, hvad du kan opbygge.

Profilerne eksporteres til en enkelt fil, som kan deles med venner eller klassekammerater. Filen kan også offentliggøres på Elgato Marketplace, hvilket betyder, at et layout, du har oprettet til et bestemt stykke laboratoriesoftware eller en bestemt værktøjskæde, kan installeres af alle, der bruger det samme.

Dette er den nemmeste måde at gå fra at bruge Stream Deck til at udgive indhold til det. Der kræves slet ingen kodning.

Husk, at det ikke kun handler om Stream Deck Neo, men om et helt Stream Deck-økosystem på flere enheder. Det er en god idé at tjekke »Explore Stream Deck« ud for at få et hurtigt overblik, inden du går videre med at udforske, hvad du kan gøre med SDK’en.

Alt, hvad Stream Deck kan ud over de indbyggede handlinger, sker via plugins, og SDK’en til at udvikle dem er offentligt tilgængelig og dokumenteret på docs.elgato.com/sdk. En ting skal vi lige slå fast fra starten: Plugins er skrevet i TypeScript og kører på Node.js – ikke i C og C++, som du skal bruge dit første semester på. Hvis du aldrig har rørt ved nogen af delene før, er det snarere et spørgsmål om en weekend end et helt semester, og TypeScript er alligevel det sprog, som de fleste af de værktøjer, du bruger, er skrevet i. Det tager ikke lang tid at få et plugin til at fungere:

1. Installer Node.js, version 24 eller nyere.
2. Installer Stream Deck CLI fra npm.
3. Kør kommandoen »streamdeck create«. Guiden opretter et komplet, fungerende plugin.
4. Kør kommandoen »npm run watch« og rediger. Ændringer indlæses automatisk på enheden, mens den er tilsluttet.

De eksempler på plugins, der findes på GitHub, er fuldt funktionsdygtige plugins, som du kan klone, køre og undersøge nærmere. Her er nogle eksempler, der kan hjælpe dig i gang. Dokumentationen vil være vigtig, når du går mere i dybden.

Elgato Marketplace er det sted, hvor Stream Deck-plugins, profiler, ikoner, pauseskærme og lydkort distribueres. Når du offentliggør indhold her, bliver du en Elgato Maker. Opsætningen foregår i tre trin, som kun skal udføres én gang:

1. Gå til Maker Console og opret din organisation.
2. Underskriv Maker-aftalen.
3. Indsend dit produkt. Alt gennemgår en gennemgang, før det bliver opført.

Du fastsætter selv prisen, og du kan udgive gratis. For betalte produkter gælder en fordeling på 70/30. Du beholder 70 %, mens Elgato tager 30 %, og udbetalingerne håndteres via Stripe Connect. Der er ingen landebegrænsninger for gratis produkter. Alle detaljer findes i Maker-dokumentationen.

• Maker Discord — dem, der lever af at udvikle plugins og profiler, og som besvarer spørgsmål. Det hurtigste sted at få hjælp, når du sidder fast.
• Dokumentation til udviklere — alt, hvad du kan udgive, og hvordan indsendelsen foregår.
• Maker-nyhedsbrev — SDK-udgivelser, nyheder om formularer og hvad andre makers har lanceret. Vi planlægger noget specielt til studerende, der er makers; det vil blive annonceret først i nyhedsbrevet.