Jellyfin
Dołączona do Macro DeckSteruj aplikacjami Jellyfin i telewizorami z decku, pokazuj, co jest odtwarzane, i reaguj na rozpoczęcie lub zatrzymanie odtwarzania.
Dwa widżety Odtwarzacz muzyki odtwarzające utwór, jeden w stylu Pełna okładka, drugi w stylu Mała okładka, oba z nazwą i logo Jellyfin w nagłówku
- Sterowanie odtwarzaniem i głośnością w aplikacjach Jellyfin, przeglądarkach i telewizorach
- Wyszukiwanie i uruchamianie filmu, odcinka, utworu lub albumu
- Wyzwalacze przy rozpoczęciu, wstrzymaniu, wznowieniu i zatrzymaniu odtwarzania
- Widżety Odtwarzacz muzyki i Sesje Jellyfin
- Połączenie kilku serwerów, każdy z własnymi zmiennymi
Integracja Jellyfin łączy Macro Deck z jednym lub kilkoma serwerami multimediów Jellyfin i współpracuje z ich sesjami: zalogowanymi i odtwarzającymi aplikacjami Jellyfin, przeglądarkami i telewizorami. Nie wymaga wtyczki Jellyfin. Logowanie odbywa się kluczem API, dzięki któremu Macro Deck widzi wszystkie sesje na serwerze i nimi steruje, albo nazwą użytkownika i hasłem, co ogranicza go do sesji, którymi to konto może sterować.
Możliwości
- Odtwarzanie, wstrzymywanie, zatrzymywanie, przełączanie pozycji, przewijanie do wybranego miejsca oraz przeskakiwanie do przodu i do tyłu o podaną liczbę sekund.
- Ustawianie głośności, wyciszanie i wyłączanie wyciszenia oraz ustawianie odtwarzania losowego i powtarzania na kliencie.
- Wyszukiwanie na serwerze filmu, odcinka, utworu lub albumu i uruchamianie go na urządzeniu akcją Odtwórz multimedia.
- Wyświetlanie wiadomości z nagłówkiem na kliencie Jellyfin.
- Pokazywanie bieżącego odtwarzania w widżecie Odtwarzacz muzyki albo odtwarzania na serwerach w widżecie Sesje Jellyfin.
- Uruchamianie automatyzacji przy rozpoczęciu, wstrzymaniu, wznowieniu lub zatrzymaniu odtwarzania, zmianie pozycji albo połączeniu klienta.
Przykładowe zastosowania:
- Przycisk Toggle Play/Pause dla telewizora w salonie, a obok niego Przewiń do tyłu, aby powtórzyć ostatnie 10 sekund.
- Automatyzacja na zdarzenie Odtwarzanie rozpoczęte dla telewizora, która przyciemnia światła, gdy
{{ event.itemType }}ma wartośćMovie, i druga na Odtwarzanie zatrzymane, która je rozjaśnia. - Przycisk, który akcją Pokaż wiadomość wyświetla na telewizorze „Obiad gotowy”.
Serwery i urządzenia
Każdy dodany serwer pojawia się w dwóch postaciach wszędzie tam, gdzie wybiera się odtwarzacz. Nazwa serwera wskazuje sesję, która ostatnio coś odtwarzała. Serwer · Urządzenie, np. Home · Living Room TV, zawsze wskazuje konkretne urządzenie i jest oznaczone jako niepołączone, gdy urządzenie jest wyłączone. Macro Deck pamięta urządzenia przez 30 dni od ostatniego ich wykrycia.
W Jellyfin 10.11 i nowszym Macro Deck śledzi serwer na żywo przez jego WebSocket. Gdy serwer nie wysyła aktualizacji na żywo, Macro Deck pyta o sesje co dwie sekundy. Gdy serwer zniknie, Macro Deck ponawia próby w tle i po kilku nieudanych próbach zgłasza to na stronie Jellyfin w sekcji Integracje. Nie każdy klient Jellyfin obsługuje każde polecenie: polecenie, którego klient nie może wykonać, kończy się komunikatem.
Czego potrzebujesz
- Serwer Jellyfin osiągalny przez sieć z komputera, na którym działa Macro Deck.
- Klucz API z panelu Jellyfin (zalecane) albo nazwa użytkownika i hasło Jellyfin.
- Jellyfin 10.11 lub nowszy dla aktualizacji na żywo. Bez nich Macro Deck pyta o sesje co dwie sekundy.
Konfiguracja krok po kroku
Krok 1: Utwórz klucz API w Jellyfin
Otwórz panel Jellyfin i przejdź do Klucze API. Utwórz nowy klucz i skopiuj go. Przy logowaniu kontem użytkownika pomiń ten krok.
Krok 2: Dodaj konfigurację w Macro Deck
W Macro Deck kliknij Integracje na pasku bocznym, a następnie Jellyfin. Na karcie Przegląd kliknij Dodaj konfigurację w sekcji Konfiguracja. Włączenie przełącznika w prawym górnym rogu otwiera to samo okno, a integracja zostaje włączona po zakończeniu konfiguracji.
Krok 3: Wprowadź dane serwera
W oknie Połącz z Jellyfin wypełnij:
- Nazwa konfiguracji: nazwa tego serwera, np.
Home. Jest używana w nazwach odtwarzaczy i zmiennych. - Adres serwera: adres z portem i ewentualną ścieżką bazową, np.
http://192.168.1.10:8096. - Zaloguj przez: Klucz API lub Nazwa użytkownika i hasło, a następnie wpisz Klucz API albo Nazwa użytkownika i Hasło.
Kliknij Dalej. Macro Deck sprawdzi połączenie przed zapisaniem.
- Nazwa konfiguracji: nazwa tego serwera, np.
Krok 4: Sprawdź połączenie
Nowa konfiguracja ma stan Połączono w sekcji Konfiguracja na stronie Jellyfin. Powtórz te kroki dla każdego kolejnego serwera.
Krok 5: Dodaj akcję do przycisku
Na stronie Deck kliknij przycisk, który ma zostać użyty. Deck musi być odblokowany: jest odblokowany, gdy przycisk w prawym górnym rogu ma etykietę Zablokuj. Otworzy się edytor z zaznaczonym Krótkie naciśnięcie. Kliknij + Dodaj akcję, po lewej stronie okna Dodaj akcję wybierz Jellyfin i wybierz akcję, np. Toggle Play/Pause. Wskaż serwer lub urządzenie, którym ma sterować, a następnie kliknij Zapisz.
Krok 6: Naciśnij przycisk
Uruchom coś w kliencie Jellyfin i naciśnij przycisk na decku. Odtwarzanie na tym kliencie zostanie wstrzymane lub wznowione.
Akcje20
Przypisz je do przycisku lub uruchamiaj w przebiegu.
- Play
- Wznawia odtwarzanie na kliencie.
- Pause
- Wstrzymuje odtwarzanie na kliencie.
- Toggle Play/Pause
- Przełącza między odtwarzaniem a wstrzymaniem i pokazuje stan odtwarzania na przycisku.
- Zatrzymaj
- Zatrzymuje odtwarzanie na kliencie.
- Next Track
- Przechodzi do następnej pozycji.
- Previous Track
- Przechodzi do poprzedniej pozycji.
- Refresh State
- Od razu odczytuje bieżący stan odtwarzania.
- Seek
- Przeskakuje do wybranego miejsca bieżącej pozycji, w sekundach.
- Przewiń do przodu
- Przeskakuje do przodu w bieżącej pozycji, domyślnie o 30 sekund.
- Przewiń do tyłu
- Przeskakuje do tyłu w bieżącej pozycji, domyślnie o 10 sekund.
- Set Volume
- Ustawia głośność klienta w zakresie od 0 do 100%.
- Volume Up
- Zwiększa głośność o 10%.
- Volume Down
- Zmniejsza głośność o 10%.
- Wycisz
- Wycisza klienta.
- Wyłącz wyciszenie
- Ponownie włącza dźwięk klienta.
- Przełącz wyciszenie
- Wycisza klienta lub wyłącza wyciszenie.
- Toggle Shuffle
- Włącza, wyłącza lub przełącza odtwarzanie losowe.
- Set Repeat Mode
- Ustawia powtarzanie na Off, Repeat Track lub Repeat Album/Playlist.
- Pokaż wiadomość
- Wyświetla na kliencie wiadomość z nagłówkiem przez podaną liczbę sekund.
- Odtwórz multimedia
- Wyszukuje film, odcinek, utwór lub album i uruchamia go na kliencie, zastępując bieżące odtwarzanie.
Wyzwalacze9
Przycisk lub przebieg może reagować na te zdarzenia.
- Odtwarzanie rozpoczęte
- Sesja rozpoczęła odtwarzanie.
- Odtwarzanie wstrzymane
- Odtwarzanie w sesji zostało wstrzymane.
- Odtwarzanie wznowione
- Wstrzymane odtwarzanie w sesji zostało wznowione.
- Odtwarzanie zatrzymane
- Sesja zakończyła odtwarzanie.
- Zmieniono odtwarzaną pozycję
- Sesja przeszła do innego filmu, odcinka lub utworu.
- Sesja połączona
- Klient Jellyfin otworzył sesję na serwerze.
- Sesja rozłączona
- Serwer zamknął sesję klienta.
- Połączono
- Macro Deck połączył się z serwerem.
- Rozłączono
- Macro Deck utracił połączenie z serwerem.
Zmienne7
Wyświetlaj te wartości na przyciskach i widżetach albo używaj ich w warunkach.
jellyfin_active_sessions- Sesje odtwarzające lub wstrzymane na wszystkich serwerach łącznie.
jellyfin_<server>_is_connected,jellyfin_<server>_active_sessions- Czy Macro Deck łączy się z każdym serwerem i ile sesji na nim odtwarza.
jellyfin_<server>_<device>_is_playing,jellyfin_<server>_<device>_is_paused,jellyfin_<server>_<device>_is_active- Czy na urządzeniu coś jest odtwarzane, wstrzymane lub wczytane. Zapis do zmiennej odtwarzania lub wstrzymania uruchamia lub wstrzymuje odtwarzanie.
jellyfin_<server>_<device>_title,jellyfin_<server>_<device>_series,jellyfin_<server>_<device>_album,jellyfin_<server>_<device>_media_type- Tytuł, serial, album (lub sezon) i typ multimediów pozycji na każdym urządzeniu.
jellyfin_<server>_<device>_position,jellyfin_<server>_<device>_duration,jellyfin_<server>_<device>_progress_percent- Pozycja i czas trwania w sekundach oraz postęp w procentach. Zapis do pozycji lub postępu przeskakuje do danego miejsca.
jellyfin_<server>_<device>_user,jellyfin_<server>_<device>_client,jellyfin_<server>_<device>_device,jellyfin_<server>_<device>_is_transcoding- Użytkownik, klient i urządzenie każdej sesji oraz informacja, czy serwer konwertuje multimedia.
jellyfin_<server>_<device>_volume,jellyfin_<server>_<device>_is_muted- Głośność i stan wyciszenia każdego urządzenia, jeśli je zgłasza. Zapis do nich ustawia głośność lub wycisza.
Widżety2
Dodaj je do decku z selektora widżetów.
- Odtwarzacz muzyki
- Pokazuje, co jest odtwarzane na serwerze lub urządzeniu, z grafiką, postępem i przyciskami odtwarzania, wstrzymania i przełączania. Wiersze dopasowują się do utworów, odcinków i filmów.
- Sesje Jellyfin
- Pokazuje, co jest odtwarzane na jednym lub wszystkich serwerach, z okładką lub plakatem, informacją, kto odtwarza, na jakim urządzeniu i jaki jest postęp.
Najczęściej zadawane pytania
Czy używać klucza API, czy nazwy użytkownika i hasła?
Zalecany jest klucz API: Macro Deck widzi wtedy wszystkie sesje na serwerze i nimi steruje. Z nazwą użytkownika i hasłem widzi tylko sesje, którymi to konto może sterować. Hasło jest używane jednorazowo do logowania i nie jest przechowywane; Macro Deck zachowuje tylko token dostępu wydany przez Jellyfin.
Czy mogę połączyć więcej niż jeden serwer?
Tak. Dodaj osobną konfigurację dla każdego serwera. Każda ma własne zmienne, nazwane według konfiguracji, i pokazuje, czy jest połączona.
Dlaczego polecenie nie działa na telewizorze lub w przeglądarce?
Nie każdy klient Jellyfin obsługuje każde polecenie. Macro Deck wysyła tylko to, co według zgłoszenia klienta jest obsługiwane, więc polecenie, którego klient nie może wykonać, kończy się komunikatem. Głośność i wyciszenie zwykle działają tylko w aplikacjach Jellyfin, a nie w karcie przeglądarki.
Co się dzieje, gdy serwer jest offline?
Macro Deck ponawia próby w tle i po kilku nieudanych próbach pokazuje problem Serwer Jellyfin jest nieosiągalny na stronie Jellyfin w sekcji Integracje. Akcje dla tego serwera kończą się komunikatem, dopóki serwer nie wróci.
Czy używać wyzwalaczy Jellyfin, czy wyzwalaczy odtwarzacza muzyki?
Wyzwalacze odtwarzacza muzyki, np. Odtwarzanie rozpoczęte w grupie Music Player, uruchamiają się także dla Jellyfin, raz dla serwera i raz dla urządzenia. Do automatyzacji lepiej nadają się wyzwalacze Jellyfin: uruchamiają się raz na urządzenie i przekazują użytkownika oraz typ multimediów.
Więcej w kategorii Muzyka i dźwięk
Spotify
Dołączona do Macro DeckSteruj odtwarzaniem Spotify, oznaczaj utwory jako polubione, zarządzaj playlistami i pokazuj na decku, co jest odtwarzane.
YouTube Music Desktop App
Dołączona do Macro DeckSteruj YouTube Music Desktop App z decku: odtwarzanie, głośność, oceny i bieżący utwór.
WebNowPlaying
Dołączona do Macro DeckSteruj muzyką i filmami odtwarzanymi w przeglądarce i pokazuj, co jest odtwarzane, za pomocą rozszerzenia WebNowPlaying.
SoundPad
Dołączona do Macro DeckOdtwarzaj dźwięki z listy SoundPad, steruj nagraniami i pokazuj na decku odtwarzany dźwięk.
Voicemeeter
Dołączona do Macro DeckSteruj wzmocnieniem, wyciszeniem, routingiem i przyciskami makr Voicemeeter, Banana lub Potato z decku.