Jellyfin
In Macro Deck enthaltenSteuere Jellyfin-Apps und Fernseher von deinem Deck, zeige, was läuft, und reagiere, wenn die Wiedergabe startet oder stoppt.
Zwei Widgets Musik-Player, die einen Titel spielen, eines im Stil Vollflächiges Cover und eines im Stil Kleines Cover, beide mit Name und Logo von Jellyfin in der Kopfzeile
- Wiedergabe und Lautstärke in Jellyfin-Apps, Browsern und auf Fernsehern steuern
- Nach einem Film, einer Episode, einem Song oder Album suchen und es starten
- Auslöser, wenn die Wiedergabe startet, pausiert, fortgesetzt wird oder stoppt
- Widgets Musik-Player und Jellyfin-Sitzungen
- Mehrere Server verbinden, jeder mit eigenen Variablen
Die Jellyfin-Integration verbindet Macro Deck mit einem oder mehreren Jellyfin-Medienservern und arbeitet mit deren Sitzungen: den Jellyfin-Apps, Browsern und Fernsehern, die angemeldet sind und abspielen. Ein Jellyfin-Plugin ist nicht nötig. Du meldest dich mit einem API-Schlüssel an, mit dem Macro Deck jede Sitzung auf dem Server sehen und steuern kann, oder mit Benutzername und Passwort, was es auf die Sitzungen beschränkt, die dieses Konto steuern darf.
Was du damit machen kannst
- Abspielen, pausieren, stoppen, überspringen, an eine Position springen oder um eine Anzahl Sekunden vor- und zurückspringen.
- Die Lautstärke festlegen, stumm- und wieder laut schalten und Zufallswiedergabe und Wiederholung an einem Client festlegen.
- Auf dem Server nach einem Film, einer Episode, einem Song oder Album suchen und es mit Medien abspielen auf einem Gerät starten.
- Eine Nachricht mit Überschrift auf einem Jellyfin-Client anzeigen.
- Im Widget Musik-Player zeigen, was läuft, oder im Widget Jellyfin-Sitzungen die Wiedergabe auf deinen Servern.
- Eine Automation starten, wenn die Wiedergabe startet, pausiert, fortgesetzt wird oder stoppt, wenn das Element wechselt oder wenn sich ein Client verbindet.
Einige Beispiele:
- Eine Taste Toggle Play/Pause für den Fernseher im Wohnzimmer, daneben Zurückspulen, um die letzten 10 Sekunden zu wiederholen.
- Eine Automation auf Wiedergabe gestartet für deinen Fernseher, die das Licht dimmt, wenn
{{ event.itemType }}Movieist, und eine zweite auf Wiedergabe beendet, die es wieder hochdreht. - Eine Taste, die mit Nachricht anzeigen „Essen ist fertig“ auf dem Fernseher anzeigt.
Server und Geräte
Jeder Server, den du hinzufügst, erscheint überall, wo du einen Player auswählst, in zwei Formen. Der Servername folgt der Sitzung, die zuletzt etwas abgespielt hat. Server · Gerät, zum Beispiel Home · Living Room TV, zielt immer auf dieses Gerät und wird als nicht verbunden angezeigt, solange das Gerät aus ist. Macro Deck merkt sich Geräte 30 Tage, nachdem es sie zuletzt gesehen hat.
Ab Jellyfin 10.11 verfolgt Macro Deck einen Server live über seinen WebSocket. Sendet ein Server keine Live-Aktualisierungen, fragt es stattdessen alle zwei Sekunden nach den Sitzungen. Verschwindet ein Server, versucht Macro Deck es im Hintergrund weiter und meldet das nach einigen fehlgeschlagenen Versuchen auf der Jellyfin-Seite unter Integrationen. Nicht jeder Jellyfin-Client unterstützt jeden Befehl: Ein Befehl, den der Client nicht ausführen kann, schlägt mit einer Meldung fehl.
Das brauchst du
- Ein Jellyfin-Server, den der Computer mit Macro Deck über das Netzwerk erreicht.
- Ein API-Schlüssel aus dem Jellyfin-Dashboard (empfohlen) oder ein Jellyfin-Benutzername mit Passwort.
- Jellyfin 10.11 oder neuer für Live-Aktualisierungen. Ohne sie fragt Macro Deck alle zwei Sekunden nach den Sitzungen.
So richtest du sie ein
Schritt 1: API-Schlüssel in Jellyfin erstellen
Öffne das Jellyfin-Dashboard und geh zu API-Schlüssel. Erstelle einen neuen Schlüssel und kopiere ihn. Wenn du dich lieber mit einem Benutzerkonto anmeldest, überspringe diesen Schritt.
Schritt 2: Konfiguration in Macro Deck hinzufügen
Klicke in Macro Deck in der Seitenleiste auf Integrationen und dann auf Jellyfin. Klicke im Tab Übersicht im Abschnitt Konfiguration auf Konfiguration hinzufügen. Der Schalter oben rechts öffnet denselben Dialog, und die Integration ist eingeschaltet, sobald die Einrichtung abgeschlossen ist.
Schritt 3: Serverdaten eingeben
Fülle im Dialog Mit Jellyfin verbinden Folgendes aus:
- Konfigurationsname: ein Name für diesen Server, zum Beispiel
Home. Er wird in Player-Namen und Variablen verwendet. - Serveradresse: die Adresse mit Port und gegebenenfalls Basispfad, zum Beispiel
http://192.168.1.10:8096. - Anmelden mit: API-Schlüssel oder Benutzername und Passwort, dann gib den API-Schlüssel oder Benutzername und Passwort ein.
Klicke auf Fortfahren. Macro Deck prüft die Verbindung, bevor es speichert.
- Konfigurationsname: ein Name für diesen Server, zum Beispiel
Schritt 4: Verbindung prüfen
Die neue Konfiguration zeigt im Abschnitt Konfiguration der Jellyfin-Seite Verbunden. Wiederhole die Schritte für jeden weiteren Server.
Schritt 5: Aktion zu einer Taste hinzufügen
Klicke auf der Seite Deck auf die Taste, die du verwenden willst. Das Deck muss entsperrt sein: Zeigt die Schaltfläche oben rechts Sperren, ist es entsperrt. Der Editor öffnet sich mit ausgewähltem Kurzer Druck. Klicke auf + Aktion hinzufügen, wähle links im Dialog Aktion hinzufügen Jellyfin und nimm eine Aktion wie Toggle Play/Pause. Wähle den Server oder das Gerät, das sie steuert, und klicke dann auf Speichern.
Schritt 6: Taste drücken
Starte etwas auf dem Jellyfin-Client und drücke die Taste auf deinem Deck. Die Wiedergabe pausiert oder läuft auf diesem Client weiter.
Aktionen20
Lege sie auf eine Taste oder führe sie in einem Ablauf aus.
- Play
- Setzt die Wiedergabe auf dem Client fort.
- Pause
- Pausiert die Wiedergabe auf dem Client.
- Toggle Play/Pause
- Wechselt zwischen Wiedergabe und Pause und zeigt den Wiedergabestatus auf der Taste.
- Stopp
- Stoppt die Wiedergabe auf dem Client.
- Next Track
- Springt zum nächsten Element.
- Previous Track
- Springt zum vorherigen Element.
- Refresh State
- Liest den aktuellen Wiedergabestatus sofort.
- Seek
- Springt im aktuellen Element an eine Position, in Sekunden.
- Vorspulen
- Springt im aktuellen Element vor, standardmäßig 30 Sekunden.
- Zurückspulen
- Springt im aktuellen Element zurück, standardmäßig 10 Sekunden.
- Set Volume
- Legt die Lautstärke des Clients fest, von 0 bis 100 %.
- Volume Up
- Erhöht die Lautstärke um 10 %.
- Volume Down
- Verringert die Lautstärke um 10 %.
- Stummschalten
- Schaltet den Client stumm.
- Stummschaltung aufheben
- Schaltet den Ton des Clients wieder ein.
- Stummschaltung umschalten
- Schaltet den Client stumm oder wieder laut.
- Toggle Shuffle
- Schaltet die Zufallswiedergabe ein, aus oder um.
- Set Repeat Mode
- Stellt die Wiederholung auf Off, Repeat Track oder Repeat Album/Playlist.
- Nachricht anzeigen
- Zeigt eine Nachricht mit Überschrift für eine Anzahl Sekunden auf dem Client.
- Medien abspielen
- Sucht nach einem Film, einer Episode, einem Song oder Album und startet es auf dem Client, anstelle dessen, was dort läuft.
Auslöser9
Eine Taste oder ein Ablauf kann auf diese Ereignisse reagieren.
- Wiedergabe gestartet
- Eine Sitzung hat angefangen, etwas abzuspielen.
- Wiedergabe pausiert
- Die Wiedergabe wurde in einer Sitzung pausiert.
- Wiedergabe fortgesetzt
- Eine pausierte Wiedergabe läuft in einer Sitzung weiter.
- Wiedergabe beendet
- Eine Sitzung hat die Wiedergabe beendet.
- Wiedergabe gewechselt
- Eine Sitzung ist zu einem anderen Film, einer anderen Episode oder einem anderen Titel gewechselt.
- Sitzung verbunden
- Ein Jellyfin-Client hat eine Sitzung auf dem Server geöffnet.
- Sitzung getrennt
- Der Server hat die Sitzung eines Clients geschlossen.
- Verbunden
- Macro Deck hat sich mit dem Server verbunden.
- Getrennt
- Macro Deck hat die Verbindung zum Server verloren.
Variablen7
Zeige diese Werte auf Tasten und Widgets an oder nutze sie in Bedingungen.
jellyfin_active_sessions- Sitzungen, die auf allen Servern zusammen abspielen oder pausiert sind.
jellyfin_<server>_is_connected,jellyfin_<server>_active_sessions- Ob Macro Deck jeden Server erreicht und wie viele Sitzungen dort abspielen.
jellyfin_<server>_<device>_is_playing,jellyfin_<server>_<device>_is_paused,jellyfin_<server>_<device>_is_active- Ob auf dem Gerät etwas abgespielt wird, pausiert ist oder geladen ist. Schreiben auf die Variable für Wiedergabe oder Pause spielt ab oder pausiert.
jellyfin_<server>_<device>_title,jellyfin_<server>_<device>_series,jellyfin_<server>_<device>_album,jellyfin_<server>_<device>_media_type- Titel, Serie, Album (oder Staffel) und Medientyp des Elements auf jedem Gerät.
jellyfin_<server>_<device>_position,jellyfin_<server>_<device>_duration,jellyfin_<server>_<device>_progress_percent- Position und Dauer in Sekunden und der Fortschritt in Prozent. Schreiben auf die Position oder den Fortschritt springt an diese Stelle.
jellyfin_<server>_<device>_user,jellyfin_<server>_<device>_client,jellyfin_<server>_<device>_device,jellyfin_<server>_<device>_is_transcoding- Benutzer, Client und Gerät jeder Sitzung und ob der Server die Medien umwandelt.
jellyfin_<server>_<device>_volume,jellyfin_<server>_<device>_is_muted- Lautstärke und Stummschaltung jedes Geräts, sofern es sie meldet. Schreiben darauf legt die Lautstärke fest oder schaltet stumm.
Widgets2
Füge sie über die Widget-Auswahl zu deinem Deck hinzu.
- Musik-Player
- Zeigt, was auf einem Server oder Gerät läuft, mit Bild, Fortschritt sowie Wiedergabe-, Pause- und Überspringen-Schaltflächen. Die Zeilen passen sich an Songs, Episoden und Filme an.
- Jellyfin-Sitzungen
- Zeigt, was auf einem oder allen deinen Servern läuft, mit Cover oder Poster, wer es abspielt, auf welchem Gerät und wie weit es ist.
Häufige Fragen
Sollte ich einen API-Schlüssel oder Benutzername und Passwort verwenden?
Ein API-Schlüssel wird empfohlen: Dann sieht und steuert Macro Deck jede Sitzung auf dem Server. Mit Benutzername und Passwort sieht es nur die Sitzungen, die dieses Konto steuern darf. Das Passwort wird einmal zur Anmeldung verwendet und nicht gespeichert; Macro Deck behält nur das Zugriffstoken, das Jellyfin ausgibt.
Kann ich mehr als einen Server verbinden?
Ja. Füge pro Server eine Konfiguration hinzu. Jede hat eigene Variablen, benannt nach der Konfiguration, und zeigt, ob sie verbunden ist.
Warum schlägt ein Befehl auf meinem Fernseher oder im Browser fehl?
Nicht jeder Jellyfin-Client unterstützt jeden Befehl. Macro Deck sendet nur, was der Client als möglich meldet, daher schlägt ein Befehl, den er nicht ausführen kann, mit einer Meldung fehl. Lautstärke und Stummschaltung funktionieren meist nur in den Jellyfin-Apps, nicht in einem Browser-Tab.
Was passiert, wenn der Server offline ist?
Macro Deck versucht es im Hintergrund weiter und zeigt nach einigen fehlgeschlagenen Versuchen auf der Seite Integrationen das Problem Jellyfin-Server nicht erreichbar. Aktionen für diesen Server schlagen mit einer Meldung fehl, bis er wieder da ist.
Sollte ich die Jellyfin-Auslöser oder die Musik-Player-Auslöser verwenden?
Die Musik-Player-Auslöser, etwa Wiedergabe gestartet unter Music Player, lösen auch für Jellyfin aus, einmal für den Server und einmal für das Gerät. Für Automationen sind die Jellyfin-Auslöser die bessere Wahl: Sie lösen einmal pro Gerät aus und enthalten den Benutzer und die Art der Medien.
Mehr in „Musik und Audio“
Spotify
In Macro Deck enthaltenSteuere die Spotify-Wiedergabe, like Songs, verwalte Playlists und zeige auf deinem Deck, was gerade läuft.
YouTube Music Desktop App
In Macro Deck enthaltenSteuere YouTube Music Desktop App von deinem Deck aus: Wiedergabe, Lautstärke, Bewertungen und was gerade läuft.
WebNowPlaying
In Macro Deck enthaltenSteuere Musik und Videos in deinem Browser und zeige, was läuft, über die Erweiterung WebNowPlaying.
SoundPad
In Macro Deck enthaltenSpiele Sounds aus deiner SoundPad-Liste ab, steuere Aufnahmen und zeige den laufenden Sound auf deinem Deck.
Voicemeeter
In Macro Deck enthaltenSteuere Pegel, Stummschaltung, Routing und Makrotasten von Voicemeeter, Banana oder Potato von deinem Deck aus.