Jellyfin
Inclusa in Macro DeckControlla app e TV Jellyfin dal deck, mostra cosa è in riproduzione e reagisci quando la riproduzione inizia o si ferma.
Due widget Lettore musicale che riproducono un brano, uno con lo stile Copertina intera e uno con lo stile Copertina piccola, entrambi con il nome e il logo di Jellyfin nell'intestazione
- Controlla riproduzione e volume su app, browser e TV Jellyfin
- Cerca un film, un episodio, un brano o un album e avvialo
- Trigger quando la riproduzione inizia, va in pausa, riprende o si ferma
- Widget Lettore musicale e Sessioni Jellyfin
- Collega più server, ognuno con le proprie variabili
L'integrazione Jellyfin collega Macro Deck a uno o più media server Jellyfin e lavora con le sessioni presenti su di essi: le app, i browser e le TV Jellyfin che hanno eseguito l'accesso e stanno riproducendo. Non richiede un plugin Jellyfin. Accedi con una chiave API, che permette a Macro Deck di vedere e controllare ogni sessione sul server, oppure con nome utente e password, che lo limitano alle sessioni che quell'account può controllare.
Cosa puoi fare
- Riproduci, metti in pausa, interrompi, salta, vai a una posizione o vai avanti e indietro di un certo numero di secondi.
- Imposta il volume, disattiva e riattiva l'audio e imposta riproduzione casuale e ripetizione su un client.
- Cerca nel server un film, un episodio, un brano o un album e avvialo su un dispositivo con Riproduci contenuto.
- Mostra un messaggio con un titolo su un client Jellyfin.
- Mostra cosa è in riproduzione nel widget Lettore musicale, oppure la riproduzione sui tuoi server nel widget Sessioni Jellyfin.
- Avvia un'automazione quando la riproduzione inizia, va in pausa, riprende o si ferma, quando cambia il contenuto o quando un client si connette.
Alcuni esempi di configurazione:
- Un pulsante Toggle Play/Pause per la TV del soggiorno, con Riavvolgi accanto per ripetere gli ultimi 10 secondi.
- Un'automazione su Riproduzione avviata per la TV che abbassa le luci quando
{{ event.itemType }}èMovie, e una seconda su Riproduzione interrotta che le rialza. - Un pulsante che mostra "La cena è pronta" sulla TV con Mostra messaggio.
Server e dispositivi
Ogni server che aggiungi compare in due forme ovunque scegli un player. Il nome del server segue la sessione che ha riprodotto qualcosa per ultima. Server · Device, per esempio Home · Living Room TV, punta sempre a quel dispositivo e risulta non connesso mentre il dispositivo è spento. Macro Deck ricorda i dispositivi per 30 giorni dall'ultima volta che li ha visti.
Macro Deck segue un server in tempo reale tramite il suo WebSocket su Jellyfin 10.11 e successivi. Quando un server non invia aggiornamenti in tempo reale, chiede invece le sessioni ogni due secondi. Quando un server sparisce, Macro Deck continua a riprovare in background e, dopo alcuni tentativi falliti, lo segnala nella pagina Jellyfin in Integrazioni. Non tutti i client Jellyfin supportano tutti i comandi: un comando che il client non può eseguire non riesce con un messaggio.
Cosa ti serve
- Un server Jellyfin che il computer su cui gira Macro Deck può raggiungere attraverso la rete.
- Una chiave API dalla dashboard di Jellyfin (consigliato), oppure nome utente e password di Jellyfin.
- Jellyfin 10.11 o successivo per gli aggiornamenti in tempo reale. Senza, Macro Deck chiede le sessioni ogni due secondi.
Configurala
Passaggio 1: Crea una chiave API in Jellyfin
Apri la dashboard di Jellyfin e vai in API Keys. Crea una nuova chiave e copiala. Se preferisci accedere con un account utente, salta questo passaggio.
Passaggio 2: Aggiungi una configurazione in Macro Deck
In Macro Deck, fai clic su Integrazioni nella barra laterale e poi su Jellyfin. Nella scheda Panoramica, fai clic su Aggiungi configurazione nella sezione Configurazione. Attivando l'interruttore in alto a destra si apre la stessa finestra, e l'integrazione si attiva al termine della configurazione.
Passaggio 3: Inserisci i dati del server
Nella finestra Connetti a Jellyfin, compila:
- Nome configurazione: un nome per questo server, per esempio
Home. Viene usato nei nomi dei player e nelle variabili. - Indirizzo del server: l'indirizzo con la porta ed eventuale percorso di base, per esempio
http://192.168.1.10:8096. - Accedi con: Chiave API o Nome utente e password, poi inserisci la Chiave API, oppure Nome utente e Password.
Fai clic su Continua. Macro Deck verifica la connessione prima di salvare.
- Nome configurazione: un nome per questo server, per esempio
Passaggio 4: Controlla la connessione
La nuova configurazione mostra Connesso nella sezione Configurazione della pagina Jellyfin. Ripeti i passaggi per ogni altro server.
Passaggio 5: Aggiungi un'azione a un pulsante
Nella pagina Deck, fai clic sul pulsante che vuoi usare. Il deck deve essere sbloccato: se il pulsante in alto a destra indica Blocca, è sbloccato. L'editor si apre con Pressione Breve selezionata. Fai clic su + Aggiungi azione, seleziona Jellyfin a sinistra nella finestra Aggiungi azione e scegli un'azione come Toggle Play/Pause. Seleziona il server o il dispositivo che controlla, poi fai clic su Salva.
Passaggio 6: Premi il pulsante
Avvia qualcosa sul client Jellyfin e premi il pulsante sul deck. La riproduzione si mette in pausa o riprende su quel client.
Azioni20
Assegnale a un pulsante o eseguile da un flusso.
- Play
- Riprende la riproduzione sul client.
- Pause
- Mette in pausa la riproduzione sul client.
- Toggle Play/Pause
- Alterna tra riproduzione e pausa e mostra lo stato della riproduzione sul pulsante.
- Interrompi
- Interrompe la riproduzione sul client.
- Next Track
- Passa al contenuto successivo.
- Previous Track
- Torna al contenuto precedente.
- Refresh State
- Legge subito lo stato attuale della riproduzione.
- Seek
- Va a una posizione del contenuto attuale, in secondi.
- Avanti veloce
- Va avanti nel contenuto attuale, di 30 secondi per impostazione predefinita.
- Riavvolgi
- Torna indietro nel contenuto attuale, di 10 secondi per impostazione predefinita.
- Set Volume
- Imposta il volume del client, da 0 a 100%.
- Volume Up
- Alza il volume del 10%.
- Volume Down
- Abbassa il volume del 10%.
- Disattiva audio
- Disattiva l'audio del client.
- Riattiva audio
- Riattiva l'audio del client.
- Attiva/disattiva audio
- Disattiva o riattiva l'audio del client.
- Toggle Shuffle
- Attiva, disattiva o alterna la riproduzione casuale.
- Set Repeat Mode
- Imposta la ripetizione su Off, Repeat Track o Repeat Album/Playlist.
- Mostra messaggio
- Mostra sul client un messaggio con un titolo per un certo numero di secondi.
- Riproduci contenuto
- Cerca un film, un episodio, un brano o un album e lo avvia sul client, sostituendo ciò che è in riproduzione.
Trigger9
Un pulsante o un flusso può reagire a questi eventi.
- Riproduzione avviata
- Una sessione ha avviato una riproduzione.
- Riproduzione in pausa
- La riproduzione è stata messa in pausa in una sessione.
- Riproduzione ripresa
- Una riproduzione in pausa è ripresa in una sessione.
- Riproduzione interrotta
- Una sessione ha interrotto la riproduzione.
- Contenuto in riproduzione cambiato
- Una sessione è passata a un altro film, episodio o brano.
- Sessione connessa
- Un client Jellyfin ha aperto una sessione sul server.
- Sessione disconnessa
- Il server ha chiuso la sessione di un client.
- Connesso
- Macro Deck si è connesso al server.
- Disconnesso
- Macro Deck ha perso la connessione al server.
Variabili7
Mostra questi valori su pulsanti e widget o usali nelle condizioni.
jellyfin_active_sessions- Le sessioni in riproduzione o in pausa su tutti i server insieme.
jellyfin_<server>_is_connected,jellyfin_<server>_active_sessions- Indica se Macro Deck raggiunge ogni server e quante sessioni sono in riproduzione lì.
jellyfin_<server>_<device>_is_playing,jellyfin_<server>_<device>_is_paused,jellyfin_<server>_<device>_is_active- Indica se sul dispositivo qualcosa è in riproduzione, in pausa o caricato. Scrivere nella variabile di riproduzione o di pausa avvia o mette in pausa la riproduzione.
jellyfin_<server>_<device>_title,jellyfin_<server>_<device>_series,jellyfin_<server>_<device>_album,jellyfin_<server>_<device>_media_type- Il titolo, la serie, l'album (o la stagione) e il tipo di contenuto su ogni dispositivo.
jellyfin_<server>_<device>_position,jellyfin_<server>_<device>_duration,jellyfin_<server>_<device>_progress_percent- La posizione e la durata in secondi e l'avanzamento in percentuale. Scrivere nella posizione o nell'avanzamento porta a quel punto.
jellyfin_<server>_<device>_user,jellyfin_<server>_<device>_client,jellyfin_<server>_<device>_device,jellyfin_<server>_<device>_is_transcoding- L'utente, il client e il dispositivo di ogni sessione, e se il server converte il contenuto.
jellyfin_<server>_<device>_volume,jellyfin_<server>_<device>_is_muted- Il volume e lo stato del muto di ogni dispositivo, dove li riporta. Scrivere in queste variabili imposta il volume o disattiva l'audio.
Widget2
Aggiungili al tuo deck dal selettore dei widget.
- Lettore musicale
- Mostra cosa è in riproduzione su un server o un dispositivo, con copertina, avanzamento e pulsanti per riprodurre, mettere in pausa e saltare. Le righe si adattano a brani, episodi e film.
- Sessioni Jellyfin
- Mostra cosa è in riproduzione su uno o su tutti i tuoi server, con copertina o locandina, chi lo riproduce, su quale dispositivo e a che punto è.
Domande frequenti
Devo usare una chiave API o nome utente e password?
È consigliata una chiave API: in quel caso Macro Deck vede e controlla ogni sessione sul server. Con nome utente e password vede solo le sessioni che quell'account può controllare. La password viene usata una volta per accedere e non viene salvata; Macro Deck conserva solo il token di accesso fornito da Jellyfin.
Posso collegare più di un server?
Sì. Aggiungi una configurazione per ogni server. Ognuna ha variabili proprie, con il nome della configurazione, e mostra se è connessa.
Perché un comando non funziona sulla mia TV o nel browser?
Non tutti i client Jellyfin supportano tutti i comandi. Macro Deck invia solo ciò che il client dichiara di saper fare, quindi un comando che non può eseguire non riesce con un messaggio. Volume e silenziamento di solito funzionano solo nelle app Jellyfin, non in una scheda del browser.
Cosa succede quando il server è offline?
Macro Deck continua a riprovare in background e dopo alcuni tentativi falliti mostra il problema Server Jellyfin non raggiungibile nella pagina Jellyfin in Integrazioni. Le azioni per quel server non riescono con un messaggio finché non torna disponibile.
Devo usare i trigger di Jellyfin o quelli di Music Player?
I trigger di Music Player, come Riproduzione avviata in Music Player, si attivano anche per Jellyfin, una volta per il server e una volta per il dispositivo. Per le automazioni sono preferibili i trigger di Jellyfin: si attivano una volta per dispositivo e includono l'utente e il tipo di contenuto.
Altro in Musica e audio
Spotify
Inclusa in Macro DeckControlla la riproduzione di Spotify, metti like ai brani, gestisci le playlist e mostra sul deck cosa è in riproduzione.
YouTube Music Desktop App
Inclusa in Macro DeckControlla YouTube Music Desktop App dal deck: riproduzione, volume, valutazioni e cosa è in riproduzione.
WebNowPlaying
Inclusa in Macro DeckControlla la musica e i video in riproduzione nel browser e mostra cosa sta suonando, tramite l'estensione WebNowPlaying.
SoundPad
Inclusa in Macro DeckRiproduci suoni dalla tua lista di SoundPad, controlla le registrazioni e mostra sul deck il suono in riproduzione.
Voicemeeter
Inclusa in Macro DeckControlla dal deck guadagno, silenziamento, instradamento e pulsanti macro di Voicemeeter, Banana o Potato.