Välkomna, förstaårsstudenter vid RWTH: Er startguide till Stream Deck Neo

Om du läser detta har du precis hämtat ett Stream Deck Neo vid välkomsttillställningen som anordnades av Fachschaft Elektrotechnik vid RWTH Aachen. Du får behålla det. Den här guiden beskriver de två saker som är värda att göra med det: att få igång det på din bärbara dator på ungefär fem minuter, och – om du vill gå ett steg längre – att bygga något för det och publicera det på Elgato Marketplace, där vem som helst kan installera det.

Stream Deck Neo är en liten styrenhet som placeras bredvid tangentbordet. Den har åtta LCD-knappar, två Touch Points för att bläddra mellan olika knappsidor och en LCD-infobar i mitten som kan visa klockslaget, CPU-belastningen eller nästa händelse i din kalender.

Varje knapp har sin egen skärm, så du ser alltid vad den gör – och det är du som bestämmer vad det ska vara. En knapp kan öppna en app, köra ett kommando, stänga av mikrofonen eller utlösa en kedja av alla tre. Den ansluts via USB-C och får ström via den anslutningen; det finns varken batteri eller nätadapter.

Stream Deck har sitt ursprung i livestreaming från 2017 och har utvecklats sedan dess. På ett skrivbord för studenter fungerar det som en genvägsbox för programvara som du redan använder.

Du behöver: en bärbar eller stationär dator med Windows 11 eller senare, eller macOS 13 eller senare, samt en ledig USB-C-port. Använder du Linux? Det finns en fråga om detta i slutet av den här artikeln.

1. Installera Stream Deck-programvaran

Ladda ner Stream Deck för Windows eller macOS. Det är gratis och det är det som gör att tangenterna kan anpassas till precis vad du behöver.

2. Koppla in den

Anslut en USB-C-kabel till din dator. Tangenterna lyser upp och programvaran identifierar enheten automatiskt. Det krävs ingen parkoppling och du behöver inte skapa något konto.

3. Ladda upp din RWTH FSET-profil

Du behöver inte börja med en tom enhet. Vi har skapat en profil för den här aktiveringen, så tangenterna är redan förinställda när de levereras.

Ladda ner RWTH FSET-profilen – dubbelklicka sedan på filen så installerar Stream Deck den.

Allt som behövs finns i den här guiden: SDK-dokumentationen, exempel på plugins, Maker Discord, Marketplace och var man kan få hjälp. Ett tryck på varje knapp, direkt från enheten. Det här är en utgångspunkt, inte en fast layout. Varje knapp kan ändras, döpas om eller tas bort.

4. Gör det till ditt eget

Det fungerar på samma sätt när du lägger till egna tangenter. I den högra panelen i programvaran visas alla funktioner som en tangent kan utföra. Öppna en webbplats, starta ett program, aktivera ett snabbtangentkommando, starta en timer, utför ett kommando. Dra en funktion till en tangent, ställ in den i panelen nedan och tryck på tangenten. Det är hela principen. För en fullständig genomgång, se snabbstartsguiden för Stream Deck.

Åtta tangenter låter kanske inte så många. Men det är det, av två skäl: med Touch Points-tangenterna bläddrar du mellan sidorna, och profilerna kan växlas automatiskt när du byter mellan olika program. Några utgångspunkter för en ingenjörsutbildning:

• Programmering. Bygg, kör, testa, committa. En Multi-Action kopplar samman flera steg till en enda tangent, så att spara, bygga och köra blir ett enda tangenttryck istället för tre.
• Föreläsningar. Starta en inspelning, öppna bilderna, placera en tidsmarkör på den del du inte hängde med i och starta en nedräkning inför nästa avsnitt.
• Laborations- och projektarbete. Starta ett mätskript, öppna loggen, växla mellan verktygen på en delad dator.
• Gruppsamtal. Stäng av ljudet, slå på kameran, dela skärmen och lämna samtalet utan att behöva leta efter rätt fönster först.

När du väl har en layout som fungerar för något av dessa har du skapat en profil. Och det är där det intressanta börjar.

En profil är en sparad tangentkonfiguration: vilka åtgärder som är kopplade till vilka tangenter, inklusive deras ikoner och inställningar. Du kan ha en profil för din textredigerare, en för föreläsningar och en för telefonsamtal, och låta Stream Deck växla mellan dem automatiskt beroende på vilken app som är aktiv.

Du har redan en: RWTH-profilen från steg 3. Öppna den i programvaran så ser du exakt hur den är uppbyggd. Vilken åtgärd som är kopplad till vilken tangent, och vad varje åtgärd är inställd att göra. Att ta isär en profil som redan fungerar är det snabbaste sättet att förstå vad du kan skapa.

Profilerna exporteras till en enda fil, som kan delas med vänner eller klasskamrater. Den filen kan också publiceras på Elgato Marketplace, vilket innebär att en layout som du har skapat för ett visst labbprogram eller en viss verktygskedja kan installeras av alla som använder samma program eller verktygskedja.

Det här är det enklaste sättet att gå från att använda Stream Deck till att publicera innehåll för det. Det kräver ingen kod alls.

Kom ihåg att det inte bara handlar om Stream Deck Neo, utan om ett helt Stream Deck-ekosystem som spänner över flera enheter. Det är bäst att ta en titt på ”Explore Stream Deck” för att få en snabb överblick innan du går vidare och utforskar vad du kan göra med SDK:t.

Allt som Stream Deck gör utöver sina inbyggda åtgärder sker via plugins, och SDK:t för att skriva dessa är offentligt och dokumenterat på docs.elgato.com/sdk. En sak som bör klargöras redan från början: plugins skrivs i TypeScript och körs på Node.js, inte i C och C++ som du kommer att ägna din första termin åt. Om du aldrig har provat något av dem är det snarare en helg än en termin som krävs för att komma igång, och TypeScript är ändå det språk som de flesta verktygen omkring dig är skrivna i. Det går snabbt att få till ett fungerande plugin:

1. Installera Node.js, version 24 eller senare.
2. Installera Stream Deck CLI från npm.
3. Kör kommandot `streamdeck create`. Guiden skapar en komplett, fungerande plugin.
4. Kör kommandot `npm run watch` och redigera. Ändringarna laddas om automatiskt på enheten medan den är ansluten.

De exempel på plugin-moduler som finns på GitHub är fullt fungerande plugin-moduler som du kan klona, köra och analysera. Här är några exempel som kan hjälpa dig att komma igång. Dokumentationen kommer att vara viktig när du fördjupar dig i ämnet.

Elgato Marketplace är den plattform där plugins, profiler, ikoner, skärmsläckare och ljudbibliotek för Stream Deck distribueras. Genom att publicera där blir du en Elgato Maker. Installationen sker i tre steg och behöver bara göras en gång:

1. Gå till Maker Console och skapa din organisation.
2. Underteckna tillverkaravtalet.
3. Skicka in din produkt. Allt granskas innan det läggs upp.

Du bestämmer själv priset och kan publicera gratis. För betalda produkter gäller en intäktsfördelning på 70/30. Du behåller 70 %, medan Elgato tar 30 %. Utbetalningarna sköts via Stripe Connect. Gratisprodukter har inga landsbegränsningar. Alla detaljer finns i Maker-dokumentationen.

• Maker Discord — de som utvecklar plugins och profiler på heltid och svarar på frågor. Det snabbaste sättet att komma vidare.
• Dokumentation för skapare — allt du kan publicera och hur inlämningen fungerar.
• Nyhetsbrev för makers — Nyheter om SDK-utgåvor, nyheter om formulär och vad andra makers har släppt. Vi planerar något speciellt för studenters som är makers; nyhetsbrevet är den första platsen där det kommer att tillkännages.