Jellyfin
Součást Macro DeckOvládejte aplikace a televize s Jellyfin z decku, zobrazujte, co hraje, a reagujte na spuštění a zastavení přehrávání.
Dva widgety Přehrávač hudby přehrávající skladbu, jeden ve stylu Celý obal a jeden ve stylu Malý obal, oba s názvem a logem Jellyfin v záhlaví
- Ovládání přehrávání a hlasitosti v aplikacích, prohlížečích a televizích s Jellyfin
- Vyhledání a spuštění filmu, epizody, skladby nebo alba
- Triggery při spuštění, pozastavení, obnovení nebo zastavení přehrávání
- Widgety Přehrávač hudby a Relace Jellyfin
- Připojení více serverů, každý s vlastními proměnnými
Integrace Jellyfin propojuje Macro Deck s jedním nebo více mediálními servery Jellyfin a pracuje s relacemi na nich: s aplikacemi Jellyfin, prohlížeči a televizemi, které jsou přihlášené a přehrávají. Nepotřebuje žádný plugin pro Jellyfin. Přihlásíte se klíčem API, se kterým Macro Deck vidí a ovládá všechny relace na serveru, nebo uživatelským jménem a heslem, se kterými se omezí na relace, jež smí ovládat daný účet.
Co můžete dělat
- Přehrát, pozastavit, zastavit, přeskočit, přejít na pozici nebo se posunout dopředu a dozadu o zadaný počet sekund.
- Nastavit hlasitost, ztlumit a zrušit ztlumení a nastavit náhodné přehrávání a opakování na klientovi.
- Vyhledat na serveru film, epizodu, skladbu nebo album a spustit ho na zařízení pomocí Přehrát média.
- Zobrazit na klientovi Jellyfin zprávu s nadpisem.
- Zobrazit, co hraje, ve widgetu Přehrávač hudby, nebo přehrávání na vašich serverech ve widgetu Relace Jellyfin.
- Spustit automatizaci, když se přehrávání spustí, pozastaví, obnoví nebo zastaví, když se změní položka nebo když se připojí klient.
Několik příkladů použití:
- Tlačítko Toggle Play/Pause pro televizi v obýváku a vedle něj Přetočit zpět, které zopakuje posledních 10 sekund.
- Automatizace s triggerem Přehrávání spuštěno pro televizi, která ztlumí světla, když
{{ event.itemType }}jeMovie, a druhá s triggerem Přehrávání zastaveno, která je zase rozsvítí. - Tlačítko, které na televizi pomocí Zobrazit zprávu zobrazí „Večeře je hotová“.
Servery a zařízení
Každý přidaný server se všude, kde vybíráte přehrávač, objeví ve dvou podobách. Název serveru sleduje tu relaci, která naposledy něco přehrávala. Server · Device, například Home · Living Room TV, vždy cílí na dané zařízení a dokud je zařízení vypnuté, zobrazuje se jako nepřipojené. Macro Deck si zařízení pamatuje 30 dní od chvíle, kdy je naposledy viděl.
Na Jellyfin 10.11 a novějším sleduje Macro Deck server živě přes jeho WebSocket. Když server živé aktualizace neposílá, ptá se místo toho na relace každé dvě sekundy. Když server zmizí, Macro Deck to na pozadí dál zkouší a po několika neúspěšných pokusech to nahlásí na stránce Jellyfin v části Integrace. Ne každý klient Jellyfin podporuje každý příkaz: příkaz, který klient nedokáže provést, selže se zprávou.
Co budete potřebovat
- Server Jellyfin, který je z počítače s Macro Deck dostupný přes síť.
- Klíč API z ovládacího panelu Jellyfin (doporučeno), nebo uživatelské jméno a heslo Jellyfin.
- Jellyfin 10.11 nebo novější pro živé aktualizace. Bez nich se Macro Deck ptá na relace každé dvě sekundy.
Nastavení
Krok 1: Vytvořte klíč API v Jellyfin
Otevřete ovládací panel Jellyfin a přejděte na API Keys. Vytvořte nový klíč a zkopírujte ho. Pokud se raději přihlásíte uživatelským účtem, tento krok přeskočte.
Krok 2: Přidejte konfiguraci v Macro Deck
V Macro Deck klikněte na postranním panelu na Integrace a pak na Jellyfin. Na kartě Přehled klikněte v části Konfigurace na Přidat konfiguraci. Stejný dialog otevře i přepínač vpravo nahoře; po dokončení nastavení se integrace zapne.
Krok 3: Zadejte údaje serveru
V dialogu Připojit k Jellyfin vyplňte:
- Název konfigurace: název tohoto serveru, například
Home. Používá se v názvech přehrávačů a proměnných. - Adresa serveru: adresa s portem a případnou základní cestou, například
http://192.168.1.10:8096. - Přihlásit pomocí: Klíč API nebo Uživatelské jméno a heslo, pak zadejte Klíč API, nebo Uživatelské jméno a Heslo.
Klikněte na Pokračovat. Macro Deck před uložením zkontroluje připojení.
- Název konfigurace: název tohoto serveru, například
Krok 4: Zkontrolujte připojení
Nová konfigurace ukazuje v části Konfigurace na stránce Jellyfin stav Připojeno. Pro každý další server kroky zopakujte.
Krok 5: Přidejte akci na tlačítko
Na stránce Deck klikněte na tlačítko, které chcete použít. Deck musí být odemčený: pokud tlačítko vpravo nahoře ukazuje Uzamknout, odemčený je. Otevře se editor s vybranou možností Krátké stisknutí. Klikněte na + Přidat akci, v dialogu Přidat akci vlevo vyberte Jellyfin a zvolte akci, například Toggle Play/Pause. Zvolte server nebo zařízení, které má ovládat, a klikněte na Uložit.
Krok 6: Stiskněte tlačítko
Spusťte něco na klientovi Jellyfin a stiskněte tlačítko na decku. Přehrávání se na tomto klientovi pozastaví nebo obnoví.
Akce20
Umístěte je na tlačítko nebo je spusťte z postupu.
- Play
- Obnoví přehrávání na klientovi.
- Pause
- Pozastaví přehrávání na klientovi.
- Toggle Play/Pause
- Přepíná mezi přehráváním a pozastavením a na tlačítku ukazuje stav přehrávání.
- Zastavit
- Zastaví přehrávání na klientovi.
- Next Track
- Přeskočí na další položku.
- Previous Track
- Přeskočí na předchozí položku.
- Refresh State
- Okamžitě načte aktuální stav přehrávání.
- Seek
- Přejde na pozici v aktuální položce, zadanou v sekundách.
- Přetočit vpřed
- Přeskočí v aktuální položce dopředu, ve výchozím stavu o 30 sekund.
- Přetočit zpět
- Přeskočí v aktuální položce zpět, ve výchozím stavu o 10 sekund.
- Set Volume
- Nastaví hlasitost klienta v rozsahu 0 až 100 %.
- Volume Up
- Zvýší hlasitost o 10 %.
- Volume Down
- Sníží hlasitost o 10 %.
- Ztlumit
- Ztlumí klienta.
- Zrušit ztlumení
- Znovu zapne zvuk klienta.
- Přepnout ztlumení
- Ztlumí klienta nebo zruší jeho ztlumení.
- Toggle Shuffle
- Zapne, vypne nebo přepne náhodné přehrávání.
- Set Repeat Mode
- Nastaví opakování na Off, Repeat Track nebo Repeat Album/Playlist.
- Zobrazit zprávu
- Zobrazí na klientovi zprávu s nadpisem na zadaný počet sekund.
- Přehrát média
- Vyhledá film, epizodu, skladbu nebo album a spustí ho na klientovi místo toho, co tam právě hraje.
Triggery9
Tlačítko nebo postup může na tyto události reagovat.
- Přehrávání spuštěno
- Relace začala něco přehrávat.
- Přehrávání pozastaveno
- Přehrávání v relaci bylo pozastaveno.
- Přehrávání obnoveno
- Pozastavené přehrávání v relaci pokračovalo.
- Přehrávání zastaveno
- Relace přestala přehrávat.
- Přehrávaná položka změněna
- Relace přešla na jiný film, epizodu nebo skladbu.
- Relace připojena
- Klient Jellyfin otevřel na serveru relaci.
- Relace odpojena
- Server ukončil relaci klienta.
- Připojeno
- Macro Deck se připojil k serveru.
- Odpojeno
- Macro Deck ztratil připojení k serveru.
Proměnné7
Zobrazte tyto hodnoty na tlačítkách a widgetech nebo je použijte v podmínkách.
jellyfin_active_sessions- Relace, které přehrávají nebo jsou pozastavené, na všech serverech dohromady.
jellyfin_<server>_is_connected,jellyfin_<server>_active_sessions- Zda je každý server pro Macro Deck dostupný a kolik relací na něm přehrává.
jellyfin_<server>_<device>_is_playing,jellyfin_<server>_<device>_is_paused,jellyfin_<server>_<device>_is_active- Zda na zařízení něco hraje, je pozastavené nebo načtené. Zápisem do proměnné pro přehrávání nebo pozastavení přehrávání spustíte nebo pozastavíte.
jellyfin_<server>_<device>_title,jellyfin_<server>_<device>_series,jellyfin_<server>_<device>_album,jellyfin_<server>_<device>_media_type- Název, seriál, album (nebo řada) a typ média položky na každém zařízení.
jellyfin_<server>_<device>_position,jellyfin_<server>_<device>_duration,jellyfin_<server>_<device>_progress_percent- Pozice a délka v sekundách a průběh v procentech. Zápisem do pozice nebo průběhu přejdete na dané místo.
jellyfin_<server>_<device>_user,jellyfin_<server>_<device>_client,jellyfin_<server>_<device>_device,jellyfin_<server>_<device>_is_transcoding- Uživatel, klient a zařízení každé relace a to, zda server média překódovává.
jellyfin_<server>_<device>_volume,jellyfin_<server>_<device>_is_muted- Hlasitost a stav ztlumení každého zařízení, pokud je hlásí. Zápisem do nich nastavíte hlasitost nebo ztlumení.
Widgety2
Přidejte je na svůj deck z výběru widgetů.
- Přehrávač hudby
- Ukazuje, co hraje na serveru nebo zařízení, s obalem, průběhem a tlačítky pro přehrání, pozastavení a přeskočení. Řádky se přizpůsobí skladbám, epizodám i filmům.
- Relace Jellyfin
- Ukazuje, co hraje na jednom nebo všech vašich serverech, s obalem nebo plakátem, kdo to přehrává, na jakém zařízení a jak daleko je.
Často kladené dotazy
Mám použít klíč API, nebo uživatelské jméno a heslo?
Doporučuje se klíč API: Macro Deck pak vidí a ovládá všechny relace na serveru. S uživatelským jménem a heslem vidí jen relace, které smí ovládat daný účet. Heslo se použije jednou k přihlášení a neukládá se; Macro Deck si ponechá jen přístupový token, který Jellyfin vydá.
Můžu připojit víc než jeden server?
Ano. Přidejte jednu konfiguraci pro každý server. Každá má vlastní proměnné pojmenované podle konfigurace a ukazuje, zda je připojená.
Proč příkaz na televizi nebo v prohlížeči selže?
Ne každý klient Jellyfin podporuje každý příkaz. Macro Deck posílá jen to, co klient hlásí, že umí, takže příkaz, který provést nedokáže, selže se zprávou. Hlasitost a ztlumení obvykle fungují jen v aplikacích Jellyfin, ne na kartě prohlížeče.
Co se stane, když je server offline?
Macro Deck to na pozadí dál zkouší a po několika neúspěšných pokusech zobrazí na stránce Jellyfin v části Integrace problém Server Jellyfin je nedostupný. Akce pro tento server selhávají se zprávou, dokud není zpět.
Mám použít triggery Jellyfin, nebo triggery Music Player?
Triggery Music Player, například Přehrávání spuštěno v kategorii Music Player, se pro Jellyfin spouštějí také, a to jednou pro server a jednou pro zařízení. Pro automatizace jsou lepší volbou triggery Jellyfin: spouštějí se jednou pro každé zařízení a nesou uživatele a typ média.
Další v kategorii Hudba a zvuk
Spotify
Součást Macro DeckOvládejte přehrávání Spotify, označujte skladby jako oblíbené, spravujte playlisty a zobrazujte na decku, co hraje.
YouTube Music Desktop App
Součást Macro DeckOvládejte YouTube Music Desktop App z decku: přehrávání, hlasitost, hodnocení a to, co právě hraje.
WebNowPlaying
Součást Macro DeckOvládejte hudbu a videa přehrávané v prohlížeči a zobrazujte, co hraje, pomocí rozšíření WebNowPlaying.
SoundPad
Součást Macro DeckPřehrávejte zvuky ze seznamu SoundPad, ovládejte nahrávání a zobrazujte přehrávaný zvuk na decku.
Voicemeeter
Součást Macro DeckOvládejte hlasitost, ztlumení, směrování a makrotlačítka Voicemeeter, Banana nebo Potato z decku.