Stream Deck – Scoreboard per Knopfdruck

Mit dem Stream Deck-Plugin steuern Sie Ihr Scoreboard direkt über die Tasten Ihres Elgato Stream Decks — ohne Maus, ohne Browserfenster. Ergebnis ändern, Spieluhr starten, Animationen auslösen: alles mit einem Tastendruck.

Voraussetzungen

• Elgato Stream Deck mit der Stream Deck Software (Version 7.0 oder neuer)
• LemonScore Desktop-App auf demselben Computer oder im selben Netzwerk
• macOS 13+ oder Windows 10+

Plugin installieren

1. Laden Sie das LemonScore Stream Deck Plugin herunter.
2. Doppelklicken Sie die Installationsdatei — die Stream Deck Software installiert das Plugin automatisch.
3. Nach der Installation erscheint die Kategorie LemonScore in der Aktionsliste der Stream Deck Software.

API-Schlüssel einrichten

Das Plugin benötigt einen API-Schlüssel, um sich mit LemonScore zu verbinden.

1. Öffnen Sie Einstellungen in LemonScore.
2. Navigieren Sie zum Tab Verbindungen.
3. Aktivieren Sie den Schalter API aktivieren.
4. Klicken Sie auf API Key erstellen und vergeben Sie eine Bezeichnung (z.B. "Stream Deck").
5. Kopieren Sie den generierten Schlüssel (beginnt mit lsk_).

6. Klicken Sie in LemonScore auf Mit Stream Deck verbinden. Die Verbindungsdaten (Host, Port, API Key) werden automatisch an das Plugin übertragen.

Falls die automatische Verbindung nicht funktioniert, tragen Sie Host, Port (4001) und API-Schlüssel manuell in den globalen Plugin-Einstellungen ein.

Verfügbare Aktionen

Das Plugin bietet 11 Aktionen, die Sie frei auf Ihrem Stream Deck platzieren können.

Score

Ändert das Ergebnis eines Teams. In den Tasteneinstellungen wählen Sie:

• Operation — Erhöhen, Verringern oder Zurücksetzen
• Team — Team 1 oder Team 2

Die Taste zeigt den aktuellen Spielstand und den Teamnamen direkt an.

Clock Start/Stop

Startet oder stoppt die Spieluhr mit einem Tastendruck. Die Taste wechselt automatisch zwischen den Zuständen "Läuft" und "Gestoppt".

Blackout

Schaltet den Bildschirm-Blackout ein oder aus. Nützlich für Pausen oder vor Spielbeginn. Der Tastenstatus aktualisiert sich automatisch.

Play Animation

Löst eine bestimmte Animation aus (z.B. Tor, Gelbe Karte, Rote Karte). Die gewünschte Animation wählen Sie in den Tasteneinstellungen.

Penalty

Steuert das Elfmeterschiessen. In den Tasteneinstellungen konfigurieren Sie die Aktion:

• Start — Elfmeterschiessen starten (mit Wahl des erstschies­senden Teams)
• Stop — Elfmeterschiessen beenden
• Ergebnis — Tor, Verschossen oder Gehalten erfassen

Playlist

Startet oder stoppt eine Playlist. Optional wählen Sie in den Einstellungen eine bestimmte Playlist aus. Die Taste zeigt den aktuellen Wiedergabestatus an.

Banner

Blendet das Werbebanner ein oder aus. Die Taste wechselt zwischen "Sichtbar" und "Ausgeblendet".

Music

Startet oder stoppt die Musikwiedergabe. Der aktuelle Status wird direkt auf der Taste angezeigt.

Volume (Drehregler)

Exklusiv für Stream Deck-Modelle mit Encoder (z.B. Stream Deck+). Drehen Sie den Regler, um die Lautstärke anzupassen. Drücken schaltet die Musik stumm.

Custom Shortcut

Führt einen in LemonScore konfigurierten Shortcut aus. Wählen Sie in den Tasteneinstellungen die gewünschte Shortcut-Karte und den Slot.

Statusanzeige

Alle Toggle-Aktionen (Clock, Blackout, Banner, Playlist, Music) zeigen den aktuellen Zustand direkt auf der Taste an. Das Plugin synchronisiert den Status automatisch mit LemonScore — auch wenn Sie Änderungen über die Desktop-App oder die Fernsteuerung vornehmen.

Fehlerbehebung

• Tasten zeigen "--" an — Das Plugin ist nicht mit LemonScore verbunden. Prüfen Sie, ob LemonScore läuft und die API aktiviert ist.
• Verbindung schlägt fehl — Stellen Sie sicher, dass Host und Port korrekt sind (Standard: localhost:4001). Testen Sie die Verbindung, indem Sie http://<host>:4001/api/v1/health im Browser aufrufen.
• API-Schlüssel ungültig — Wenn Sie einen Schlüssel in LemonScore widerrufen haben, erstellen Sie einen neuen und tragen Sie ihn im Plugin ein.
• Firewall — Bei Netzwerkbetrieb muss Port 4001 in der Firewall des LemonScore-Computers für eingehende Verbindungen freigegeben sein.

Tipps und Hinweise

• Profil anlegen — Erstellen Sie ein eigenes Stream Deck Profil für LemonScore und ordnen Sie die Aktionen nach Ihrer Arbeitsweise an.
• Multi-Aktionen — Kombinieren Sie mehrere LemonScore-Aktionen in einer Stream Deck Multi-Aktion, z.B. "Tor Team 1" (Score erhöhen + Tor-Animation abspielen).
• Mehrere Tasten — Sie können dieselbe Aktion mehrfach platzieren, z.B. eine Score-Taste pro Team.
• Netzwerkbetrieb — Das Plugin funktioniert auch über das Netzwerk. Tragen Sie die IP-Adresse des LemonScore-Computers als Host ein.