Jellyfin
Meegeleverd met Macro DeckBedien Jellyfin-apps en -tv's vanaf je deck, toon wat er speelt en reageer wanneer het afspelen start of stopt.
Twee widgets Muziekspeler die een nummer afspelen, een in de stijl Volledige hoes en een in de stijl Kleine hoes, beide met de naam en het logo van Jellyfin in de kop
- Bedien afspelen en volume in Jellyfin-apps, browsers en op tv's
- Zoek een film, aflevering, nummer of album en start het
- Triggers wanneer het afspelen start, pauzeert, hervat of stopt
- Widgets Muziekspeler en Jellyfin-sessies
- Verbind meerdere servers, elk met eigen variabelen
De integratie Jellyfin verbindt Macro Deck met een of meer Jellyfin-mediaservers en werkt met de sessies daarop: de Jellyfin-apps, browsers en tv's die zijn aangemeld en iets afspelen. Er is geen Jellyfin-plugin voor nodig. Je meldt je aan met een API-sleutel, waarmee Macro Deck elke sessie op de server kan zien en bedienen, of met een gebruikersnaam en wachtwoord, waarmee het beperkt blijft tot de sessies die dat account mag bedienen.
Wat je kunt doen
- Afspelen, pauzeren, stoppen, overslaan, naar een positie springen of een aantal seconden vooruit en terug springen.
- Het volume instellen, dempen en het dempen opheffen, en shuffle en herhalen instellen op een client.
- Op de server zoeken naar een film, aflevering, nummer of album en het met Media afspelen op een apparaat starten.
- Een bericht met een kop tonen op een Jellyfin-client.
- Tonen wat er speelt in de widget Muziekspeler, of het afspelen op je servers in de widget Jellyfin-sessies.
- Een automatisering starten wanneer het afspelen start, pauzeert, hervat of stopt, wanneer het item verandert of wanneer een client verbinding maakt.
Een paar voorbeelden:
- Een knop Toggle Play/Pause voor de tv in de woonkamer, met Terugspoelen ernaast om de laatste 10 seconden te herhalen.
- Een automatisering op Afspelen gestart voor je tv die de lampen dimt als
{{ event.itemType }}gelijk is aanMovie, en een tweede op Afspelen gestopt die ze weer feller zet. - Een knop die met Bericht tonen "Het eten is klaar" op de tv toont.
Servers en apparaten
Elke server die je toevoegt, verschijnt in twee vormen overal waar je een speler kiest. De servernaam volgt de sessie die het laatst iets heeft afgespeeld. Server · Apparaat, bijvoorbeeld Home · Living Room TV, richt zich altijd op dat apparaat en wordt als niet verbonden weergegeven zolang het apparaat uit staat. Macro Deck onthoudt apparaten 30 dagen nadat het ze voor het laatst heeft gezien.
Macro Deck volgt een server live via de WebSocket op Jellyfin 10.11 en nieuwer. Als een server geen live updates stuurt, vraagt het in plaats daarvan elke twee seconden de sessies op. Als een server wegvalt, blijft Macro Deck het op de achtergrond proberen en meldt het dat na een paar mislukte pogingen op de Jellyfin-pagina onder Integraties. Niet elke Jellyfin-client ondersteunt elke opdracht: een opdracht die de client niet kan uitvoeren, mislukt met een melding.
Wat je nodig hebt
- Een Jellyfin-server die de computer waarop Macro Deck draait via het netwerk kan bereiken.
- Een API-sleutel uit het Jellyfin-dashboard (aanbevolen), of een Jellyfin-gebruikersnaam en -wachtwoord.
- Jellyfin 10.11 of nieuwer voor live updates. Zonder die updates vraagt Macro Deck elke twee seconden de sessies op.
Instellen
Stap 1: Maak een API-sleutel aan in Jellyfin
Open het Jellyfin-dashboard en ga naar API Keys. Maak een nieuwe sleutel aan en kopieer die. Meld je je liever aan met een gebruikersaccount, sla deze stap dan over.
Stap 2: Voeg een configuratie toe in Macro Deck
Klik in Macro Deck in de zijbalk op Integraties en daarna op Jellyfin. Klik op het tabblad Overzicht in de sectie Configuratie op Configuratie toevoegen. De schakelaar rechtsboven aanzetten opent hetzelfde dialoogvenster, en de integratie wordt ingeschakeld zodra het instellen klaar is.
Stap 3: Vul de servergegevens in
Vul in het dialoogvenster Verbinden met Jellyfin het volgende in:
- Naam configuratie: een naam voor deze server, bijvoorbeeld
Home. Die wordt gebruikt in spelernamen en variabelen. - Serveradres: het adres met de poort en een eventueel basispad, bijvoorbeeld
http://192.168.1.10:8096. - Aanmelden met: API-sleutel of Gebruikersnaam en wachtwoord, en vul daarna de API-sleutel in, of de Gebruikersnaam en het Wachtwoord.
Klik op Doorgaan. Macro Deck controleert de verbinding voordat het opslaat.
- Naam configuratie: een naam voor deze server, bijvoorbeeld
Stap 4: Controleer de verbinding
De nieuwe configuratie toont Verbonden in de sectie Configuratie van de Jellyfin-pagina. Herhaal de stappen voor elke volgende server.
Stap 5: Voeg een actie aan een knop toe
Klik op de pagina Deck op de knop die je wilt gebruiken. Het deck moet ontgrendeld zijn: als op de knop rechtsboven Vergrendelen staat, is het ontgrendeld. De editor opent met Kort indrukken geselecteerd. Klik op + Actie toevoegen, selecteer links in het dialoogvenster Actie toevoegen Jellyfin en kies een actie zoals Toggle Play/Pause. Kies de server of het apparaat dat ze bedient en klik daarna op Opslaan.
Stap 6: Druk op de knop
Start iets op de Jellyfin-client en druk op de knop op je deck. Het afspelen pauzeert of gaat verder op die client.
Acties20
Zet deze op een knop of voer ze uit vanuit een actiestroom.
- Play
- Hervat het afspelen op de client.
- Pause
- Pauzeert het afspelen op de client.
- Toggle Play/Pause
- Wisselt tussen afspelen en pauzeren en toont de afspeelstatus op de knop.
- Stoppen
- Stopt het afspelen op de client.
- Next Track
- Springt naar het volgende item.
- Previous Track
- Springt naar het vorige item.
- Refresh State
- Leest de huidige afspeelstatus meteen uit.
- Seek
- Springt naar een positie in het huidige item, in seconden.
- Vooruitspoelen
- Springt vooruit in het huidige item, standaard 30 seconden.
- Terugspoelen
- Springt terug in het huidige item, standaard 10 seconden.
- Set Volume
- Stelt het volume van de client in, van 0 tot 100%.
- Volume Up
- Verhoogt het volume met 10%.
- Volume Down
- Verlaagt het volume met 10%.
- Dempen
- Dempt de client.
- Dempen opheffen
- Zet het geluid van de client weer aan.
- Dempen wisselen
- Dempt de client of heft het dempen op.
- Toggle Shuffle
- Zet shuffle aan, uit of wisselt het.
- Set Repeat Mode
- Zet herhalen op Off, Repeat Track of Repeat Album/Playlist.
- Bericht tonen
- Toont een bericht met een kop op de client gedurende een aantal seconden.
- Media afspelen
- Zoekt naar een film, aflevering, nummer of album en start het op de client, in plaats van wat daar speelt.
Triggers9
Een knop of actiestroom kan op deze gebeurtenissen reageren.
- Afspelen gestart
- Een sessie is iets gaan afspelen.
- Afspelen gepauzeerd
- Het afspelen is op een sessie gepauzeerd.
- Afspelen hervat
- Gepauzeerd afspelen is op een sessie verdergegaan.
- Afspelen gestopt
- Een sessie is gestopt met afspelen.
- Afspeelitem gewijzigd
- Een sessie is overgegaan naar een andere film, aflevering of een ander nummer.
- Sessie verbonden
- Een Jellyfin-client heeft een sessie op de server geopend.
- Sessie verbroken
- De server heeft de sessie van een client gesloten.
- Verbonden
- Macro Deck heeft verbinding gemaakt met de server.
- Niet verbonden
- Macro Deck heeft de verbinding met de server verloren.
Variabelen7
Toon deze waarden op knoppen en widgets, of gebruik ze in voorwaarden.
jellyfin_active_sessions- Sessies die afspelen of gepauzeerd zijn op alle servers samen.
jellyfin_<server>_is_connected,jellyfin_<server>_active_sessions- Of Macro Deck elke server bereikt en hoeveel sessies daar afspelen.
jellyfin_<server>_<device>_is_playing,jellyfin_<server>_<device>_is_paused,jellyfin_<server>_<device>_is_active- Of er op het apparaat iets speelt, gepauzeerd is of geladen is. Schrijven naar de variabele voor afspelen of pauzeren speelt af of pauzeert.
jellyfin_<server>_<device>_title,jellyfin_<server>_<device>_series,jellyfin_<server>_<device>_album,jellyfin_<server>_<device>_media_type- De titel, serie, het album (of seizoen) en het mediatype van het item op elk apparaat.
jellyfin_<server>_<device>_position,jellyfin_<server>_<device>_duration,jellyfin_<server>_<device>_progress_percent- De positie en duur in seconden en de voortgang in procent. Schrijven naar de positie of de voortgang springt naar dat punt.
jellyfin_<server>_<device>_user,jellyfin_<server>_<device>_client,jellyfin_<server>_<device>_device,jellyfin_<server>_<device>_is_transcoding- De gebruiker, client en het apparaat van elke sessie, en of de server de media omzet.
jellyfin_<server>_<device>_volume,jellyfin_<server>_<device>_is_muted- Het volume en de dempstatus van elk apparaat, waar het die doorgeeft. Schrijven ernaar stelt het volume in of dempt.
Widgets2
Voeg deze vanuit de widgetkiezer toe aan je deck.
- Muziekspeler
- Toont wat er op een server of apparaat speelt, met artwork, voortgang en knoppen voor afspelen, pauzeren en overslaan. De regels passen zich aan nummers, afleveringen en films aan.
- Jellyfin-sessies
- Toont wat er op een of al je servers speelt, met hoes of poster, wie het afspeelt, op welk apparaat en hoe ver het is.
Veelgestelde vragen
Moet ik een API-sleutel of een gebruikersnaam en wachtwoord gebruiken?
Een API-sleutel wordt aanbevolen: Macro Deck ziet en bedient dan elke sessie op de server. Met een gebruikersnaam en wachtwoord ziet het alleen de sessies die dat account mag bedienen. Het wachtwoord wordt één keer gebruikt om aan te melden en wordt niet opgeslagen; Macro Deck bewaart alleen het toegangstoken dat Jellyfin uitgeeft.
Kan ik meer dan één server verbinden?
Ja. Voeg een configuratie per server toe. Elke configuratie heeft eigen variabelen, vernoemd naar de configuratie, en toont of ze verbonden is.
Waarom mislukt een opdracht op mijn tv of in de browser?
Niet elke Jellyfin-client ondersteunt elke opdracht. Macro Deck stuurt alleen wat de client zegt te kunnen, dus een opdracht die de client niet kan uitvoeren, mislukt met een melding. Volume en dempen werken meestal alleen in de Jellyfin-apps, niet in een browsertabblad.
Wat gebeurt er als de server offline is?
Macro Deck blijft het op de achtergrond proberen en toont na een paar mislukte pogingen het probleem Jellyfin-server onbereikbaar op de Jellyfin-pagina onder Integraties. Acties voor die server mislukken met een melding totdat hij terug is.
Moet ik de Jellyfin-triggers of de triggers van Muziekspeler gebruiken?
De triggers van Muziekspeler, zoals Afspelen gestart onder Muziekspeler, worden ook voor Jellyfin geactiveerd, één keer voor de server en één keer voor het apparaat. Voor automatiseringen zijn de Jellyfin-triggers de betere keuze: ze worden één keer per apparaat geactiveerd en bevatten de gebruiker en het type media.
Meer in Muziek en audio
Spotify
Meegeleverd met Macro DeckBedien het afspelen in Spotify, like nummers, beheer afspeellijsten en toon op je deck wat er speelt.
YouTube Music Desktop App
Meegeleverd met Macro DeckBedien YouTube Music Desktop App vanaf je deck: afspelen, volume, waarderingen en wat er speelt.
WebNowPlaying
Meegeleverd met Macro DeckBedien muziek en video's die in je browser spelen en toon wat er speelt, via de extensie WebNowPlaying.
SoundPad
Meegeleverd met Macro DeckSpeel geluiden uit je SoundPad-lijst af, bedien opnames en toon het huidige geluid op je deck.
Voicemeeter
Meegeleverd met Macro DeckBedien versterking, dempen, routering en macroknoppen van Voicemeeter, Banana of Potato vanaf je deck.