[ e-networld.de ]

PlexToJellyfinSync

Liest zyklisch den Gesehen-Status vom Plex-Server und schreibt ihn in die NFO-Dateien für Jellyfin, für Filme und Serien. Ohne Plex Pass, mit Web-Dashboard.

MITDockerv1.4.0 · 18.09.2026
Status-Dashboard von PlexToJellyfinSync mit Karten für Plex-Verbindung, letzten und nächsten Abgleich, verarbeitete Einträge und aktualisierte NFO-Dateien

Überblick

Wer Plex und Jellyfin parallel betreibt, kennt das Problem: Was in Plex als gesehen markiert ist, weiß Jellyfin nicht. PlexToJellyfinSync schließt diese Lücke, indem es den Gesehen-Status regelmäßig aus Plex liest und in die NFO-Dateien neben den Mediendateien schreibt, aus denen Jellyfin die Benutzerdaten importiert.

Die Anwendung läuft als kleiner Container und arbeitet rein abfragend: Sie braucht keinen Plex Pass und erfasst dadurch auch Einträge, die von Hand als gesehen markiert wurden. Ein schneller inkrementeller Durchlauf prüft die Verlaufsdaten, ein periodischer vollständiger Abgleich holt Nachträgliches ein. Bestehende NFO-Dateien bleiben unangetastet, außer in den Feldern watched, playcount und lastplayed; fehlende Dateien kann das Werkzeug aus den Plex-Metadaten erzeugen.

Der wichtigste Einrichtungsschritt sind die Pfad-Mappings. Plex meldet Dateipfade so, wie der Plex-Server sie sieht, während dieser Container die gleichen Dateien unter seinem eigenen Mountpunkt findet. Ein Mapping ersetzt das Plex-Präfix durch das lokale. Entscheidend ist der Pfad, den Plex über seine API zurückgibt, nicht der Ordner, den man in der Oberfläche sieht. Ohne passendes Mapping wird ein Eintrag übersprungen und das im Log vermerkt, statt einen falschen Pfad zu schreiben.

Eine Einschränkung liegt auf der Jellyfin-Seite: Benutzerdaten aus NFO-Dateien kann Jellyfin nur für genau einen Benutzer importieren. Das Werkzeug arbeitet deshalb mit dem Plex-Server-Eigentümer. In den Jellyfin-Bibliothekseinstellungen muss der NFO-Metadatenleser aktiv sein und als Zielbenutzer derjenige eingestellt werden, der dem Plex-Eigentümer entspricht.

Funktionen

Gesehen-Status aus Plex übernehmen, ohne Plex Pass
Filme, Episoden, Staffeln und Serien abdecken
Bestehende NFO-Dateien nur in den Watch-Feldern ändern
Fehlende NFO-Dateien auf Wunsch aus den Plex-Metadaten erzeugen
Schneller inkrementeller Abgleich plus regelmäßiger vollständiger Durchlauf
Auch manuell in Plex als gesehen markierte Einträge werden erfasst
Pfad-Mappings zwischen Plex-Sicht und eigenen Mountpunkten
Web-Dashboard mit Statuskarten und Live-Logs, optional mit Token geschützt

Installation

docker run -d \
  --name plextojellyfinsync \
  -e PLEXSYNC__Plex__BaseUrl="http://plex:32400" \
  -e PLEXSYNC__Plex__Token="<Ihr-Plex-Token>" \
  -e PLEXSYNC__PathMappings__0__Plex="/data/Movies" \
  -e PLEXSYNC__PathMappings__0__Local="/media/Movies" \
  -v /pfad/zu/medien:/media \
  -v /pfad/zu/config:/config \
  -p 8080:8080 \
  networlddev/plextojellyfinsync:latest

Das Medienverzeichnis muss beschreibbar eingebunden sein. Mindestens ein passendes Pfad-Mapping ist Pflicht, sonst werden Einträge übersprungen.

Releases

v1.4.0 · 18.09.2026
  • [Security] Harden dashboard auth, cookies, and container user

GitHub ↗

v1.3.3 · 17.09.2026

Abhängigkeiten aktualisiert

GitHub ↗

v1.3.2 · 10.09.2026

Abhängigkeiten aktualisiert

GitHub ↗

v1.3.1 · 23.08.2026
  • Bump the actions group with 2 updates
  • Update Reihitsu.Analyzer, suppress RH5201, fix indentation

GitHub ↗

v1.3.0 · 16.08.2026
  • Bump the actions group with 2 updates
  • Refactor code organization and update dependencies

GitHub ↗

Alle Releases auf GitHub ↗