Jellyfin
Incluse avec Macro DeckPilotez les applications et téléviseurs Jellyfin depuis votre deck, affichez ce qui est en lecture et réagissez au début ou à la fin de la lecture.
Deux widgets Lecteur de musique qui jouent un morceau, l'un en style Pochette pleine et l'autre en style Petite pochette, tous deux avec le nom et le logo de Jellyfin dans l'en-tête
- Pilotez la lecture et le volume des applications, navigateurs et téléviseurs Jellyfin
- Cherchez un film, un épisode, un morceau ou un album et lancez-le
- Des déclencheurs quand la lecture démarre, se met en pause, reprend ou s'arrête
- Widgets Lecteur de musique et Sessions Jellyfin
- Connectez plusieurs serveurs, chacun avec ses propres variables
L'intégration Jellyfin relie Macro Deck à un ou plusieurs serveurs multimédias Jellyfin et agit sur leurs sessions : les applications, navigateurs et téléviseurs Jellyfin connectés et en lecture. Elle ne nécessite aucun plugin Jellyfin. Vous vous connectez avec une clé API, qui permet à Macro Deck de voir et de piloter toutes les sessions du serveur, ou avec un nom d'utilisateur et un mot de passe, ce qui le limite aux sessions que ce compte a le droit de piloter.
Ce que vous pouvez faire
- Lancer, mettre en pause, arrêter, passer, aller à une position ou avancer et reculer d'un nombre de secondes.
- Régler le volume, couper et rétablir le son, et définir la lecture aléatoire et la répétition sur un client.
- Chercher sur le serveur un film, un épisode, un morceau ou un album et le lancer sur un appareil avec Lire un média.
- Afficher un message avec un titre sur un client Jellyfin.
- Afficher ce qui est en lecture dans le widget Lecteur de musique, ou la lecture sur vos serveurs dans le widget Sessions Jellyfin.
- Lancer une automatisation quand la lecture démarre, se met en pause, reprend ou s'arrête, quand le média change, ou quand un client se connecte.
Quelques exemples de configuration :
- Un bouton Toggle Play/Pause pour la télévision du salon, avec Reculer à côté pour revoir les 10 dernières secondes.
- Une automatisation sur Lecture démarrée pour votre télévision qui tamise les lumières quand
{{ event.itemType }}vautMovie, et une seconde sur Lecture arrêtée qui les rallume. - Un bouton qui affiche « Le dîner est prêt » sur la télévision avec Afficher un message.
Serveurs et appareils
Chaque serveur ajouté apparaît sous deux formes partout où vous choisissez un lecteur. Le nom du serveur suit la session qui a lu quelque chose en dernier. Serveur · Appareil, par exemple Home · Living Room TV, cible toujours cet appareil et apparaît comme non connecté tant que l'appareil est éteint. Macro Deck se souvient des appareils pendant 30 jours après les avoir vus pour la dernière fois.
Macro Deck suit un serveur en direct via son WebSocket à partir de Jellyfin 10.11. Quand un serveur n'envoie pas de mises à jour en direct, Macro Deck demande les sessions toutes les deux secondes à la place. Quand un serveur disparaît, Macro Deck continue de réessayer en arrière-plan et le signale sur la page Jellyfin sous Intégrations après quelques tentatives échouées. Tous les clients Jellyfin ne prennent pas en charge toutes les commandes : une commande que le client ne peut pas exécuter échoue avec un message.
Ce qu'il vous faut
- Un serveur Jellyfin que l'ordinateur qui exécute Macro Deck peut joindre par le réseau.
- Une clé API du tableau de bord Jellyfin (recommandé), ou un nom d'utilisateur et un mot de passe Jellyfin.
- Jellyfin 10.11 ou plus récent pour les mises à jour en direct. Sans elles, Macro Deck demande les sessions toutes les deux secondes.
Configuration
Étape 1: Créez une clé API dans Jellyfin
Ouvrez le tableau de bord Jellyfin et allez dans Clés API. Créez une nouvelle clé et copiez-la. Si vous préférez vous connecter avec un compte utilisateur, passez cette étape.
Étape 2: Ajoutez une configuration dans Macro Deck
Dans Macro Deck, cliquez sur Intégrations dans la barre latérale, puis sur Jellyfin. Dans l'onglet Aperçu, cliquez sur Ajouter une configuration dans la section Configuration. Activer l'interrupteur en haut à droite ouvre la même boîte de dialogue, et l'intégration est activée une fois la configuration terminée.
Étape 3: Saisissez les informations du serveur
Dans la boîte de dialogue Se connecter à Jellyfin, renseignez :
- Nom de la configuration : un nom pour ce serveur, par exemple
Home. Il est utilisé dans les noms des lecteurs et des variables. - Adresse du serveur : l'adresse avec son port et un éventuel chemin de base, par exemple
http://192.168.1.10:8096. - Se connecter avec : Clé API ou Nom d'utilisateur et mot de passe, puis saisissez la Clé API, ou le Nom d'utilisateur et le Mot de passe.
Cliquez sur Continuer. Macro Deck vérifie la connexion avant d'enregistrer.
- Nom de la configuration : un nom pour ce serveur, par exemple
Étape 4: Vérifiez la connexion
La nouvelle configuration affiche Connecté dans la section Configuration de la page Jellyfin. Répétez ces étapes pour chaque serveur supplémentaire.
Étape 5: Ajoutez une action à un bouton
Sur la page Deck, cliquez sur le bouton que vous voulez utiliser. Le deck doit être déverrouillé : c'est le cas lorsque le bouton en haut à droite indique Verrouiller. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, sélectionnez Jellyfin à gauche de la boîte de dialogue Ajouter une action et choisissez une action comme Toggle Play/Pause. Sélectionnez le serveur ou l'appareil qu'elle pilote, puis cliquez sur Enregistrer.
Étape 6: Appuyez sur le bouton
Lancez quelque chose sur le client Jellyfin et appuyez sur le bouton de votre deck. La lecture se met en pause ou reprend sur ce client.
Actions20
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Play
- Reprend la lecture sur le client.
- Pause
- Met la lecture en pause sur le client.
- Toggle Play/Pause
- Alterne entre lecture et pause, et affiche l'état de lecture sur le bouton.
- Arrêter
- Arrête la lecture sur le client.
- Next Track
- Passe au média suivant.
- Previous Track
- Revient au média précédent.
- Refresh State
- Lit immédiatement l'état de lecture actuel.
- Seek
- Va à une position du média en cours, en secondes.
- Avancer
- Avance dans le média en cours, de 30 secondes par défaut.
- Reculer
- Recule dans le média en cours, de 10 secondes par défaut.
- Set Volume
- Règle le volume du client, de 0 à 100 %.
- Volume Up
- Augmente le volume de 10 %.
- Volume Down
- Baisse le volume de 10 %.
- Couper le son
- Coupe le son du client.
- Rétablir le son
- Rétablit le son du client.
- Activer/couper le son
- Coupe ou rétablit le son du client.
- Toggle Shuffle
- Active, désactive ou bascule la lecture aléatoire.
- Set Repeat Mode
- Règle la répétition sur Off, Repeat Track ou Repeat Album/Playlist.
- Afficher un message
- Affiche un message avec un titre sur le client pendant un nombre de secondes.
- Lire un média
- Cherche un film, un épisode, un morceau ou un album et le lance sur le client, à la place de ce qui y est en lecture.
Déclencheurs9
Un bouton ou un flux peut réagir à ces événements.
- Lecture démarrée
- Une session a commencé à lire quelque chose.
- Lecture en pause
- La lecture a été mise en pause sur une session.
- Lecture reprise
- Une lecture en pause a repris sur une session.
- Lecture arrêtée
- Une session a arrêté la lecture.
- Média en cours changé
- Une session est passée à un autre film, épisode ou morceau.
- Session connectée
- Un client Jellyfin a ouvert une session sur le serveur.
- Session déconnectée
- Le serveur a fermé la session d'un client.
- Connecté
- Macro Deck s'est connecté au serveur.
- Déconnecté
- Macro Deck a perdu la connexion au serveur.
Variables7
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
jellyfin_active_sessions- Les sessions en lecture ou en pause sur tous les serveurs réunis.
jellyfin_<server>_is_connected,jellyfin_<server>_active_sessions- Indique si Macro Deck joint chaque serveur et combien de sessions y sont en lecture.
jellyfin_<server>_<device>_is_playing,jellyfin_<server>_<device>_is_paused,jellyfin_<server>_<device>_is_active- Indique si quelque chose est en lecture, en pause ou chargé sur l'appareil. Écrire dans la variable de lecture ou de pause lance la lecture ou la met en pause.
jellyfin_<server>_<device>_title,jellyfin_<server>_<device>_series,jellyfin_<server>_<device>_album,jellyfin_<server>_<device>_media_type- Le titre, la série, l'album (ou la saison) et le type de média de l'élément sur chaque appareil.
jellyfin_<server>_<device>_position,jellyfin_<server>_<device>_duration,jellyfin_<server>_<device>_progress_percent- La position et la durée en secondes et la progression en pourcentage. Écrire dans la position ou la progression fait aller à ce point.
jellyfin_<server>_<device>_user,jellyfin_<server>_<device>_client,jellyfin_<server>_<device>_device,jellyfin_<server>_<device>_is_transcoding- L'utilisateur, le client et l'appareil de chaque session, et si le serveur convertit le média.
jellyfin_<server>_<device>_volume,jellyfin_<server>_<device>_is_muted- Le volume et l'état de sourdine de chaque appareil, quand il les signale. Y écrire règle le volume ou coupe le son.
Widgets2
Ajoutez-les à votre deck depuis le sélecteur de widgets.
- Lecteur de musique
- Affiche ce qui est en lecture sur un serveur ou un appareil, avec la pochette, la progression et des boutons lecture, pause et passer. Les lignes s'adaptent aux morceaux, épisodes et films.
- Sessions Jellyfin
- Affiche ce qui est en lecture sur un ou tous vos serveurs, avec la pochette ou l'affiche, qui le lit, sur quel appareil et où en est la lecture.
Questions fréquentes
Dois-je utiliser une clé API ou un nom d'utilisateur et un mot de passe ?
Une clé API est recommandée : Macro Deck voit et pilote alors toutes les sessions du serveur. Avec un nom d'utilisateur et un mot de passe, il ne voit que les sessions que ce compte a le droit de piloter. Le mot de passe sert une fois pour la connexion et n'est pas stocké ; Macro Deck ne conserve que le jeton d'accès fourni par Jellyfin.
Puis-je connecter plusieurs serveurs ?
Oui. Ajoutez une configuration par serveur. Chacune a ses propres variables, nommées d'après la configuration, et indique si elle est connectée.
Pourquoi une commande échoue-t-elle sur ma télévision ou dans le navigateur ?
Tous les clients Jellyfin ne prennent pas en charge toutes les commandes. Macro Deck n'envoie que ce que le client déclare savoir faire : une commande qu'il ne peut pas exécuter échoue donc avec un message. Le volume et la sourdine ne fonctionnent généralement que dans les applications Jellyfin, pas dans un onglet de navigateur.
Que se passe-t-il quand le serveur est hors ligne ?
Macro Deck continue de réessayer en arrière-plan et affiche le problème Serveur Jellyfin inaccessible sur la page Jellyfin sous Intégrations après quelques tentatives échouées. Les actions pour ce serveur échouent avec un message jusqu'à son retour.
Dois-je utiliser les déclencheurs Jellyfin ou ceux du Lecteur de musique ?
Les déclencheurs du lecteur de musique, comme Lecture démarrée sous Music Player, se déclenchent aussi pour Jellyfin, une fois pour le serveur et une fois pour l'appareil. Pour les automatisations, les déclencheurs Jellyfin sont le meilleur choix : ils se déclenchent une fois par appareil et indiquent l'utilisateur et le type de média.
Plus dans Musique et audio
Spotify
Incluse avec Macro DeckPilotez la lecture Spotify, likez des titres, gérez vos playlists et affichez ce qui est en lecture sur votre deck.
YouTube Music Desktop App
Incluse avec Macro DeckPilotez YouTube Music Desktop App depuis votre deck : lecture, volume, notes et ce qui est en lecture.
WebNowPlaying
Incluse avec Macro DeckPilotez la musique et les vidéos lues dans votre navigateur et affichez ce qui est en lecture, grâce à l'extension WebNowPlaying.
SoundPad
Incluse avec Macro DeckJouez des sons de votre liste SoundPad, pilotez les enregistrements et affichez le son en cours sur votre deck.
Voicemeeter
Incluse avec Macro DeckPilotez le gain, la sourdine, le routage et les boutons macro de Voicemeeter, Banana ou Potato depuis votre deck.