103 lines
3.8 KiB
Markdown
103 lines
3.8 KiB
Markdown
# Marvel-Playlist für Jellyfin + Seerr
|
|
|
|
Das Script prüft deine Jellyfin-Bibliothek, fordert fehlende Medien über Seerr an und baut eine chronologisch sortierte Jellyfin-Playlist. Serien werden als einzelne Episoden in Staffel-/Episodenreihenfolge eingefügt.
|
|
|
|
## Version 2026.08.03-r2
|
|
|
|
Die Timeline enthält nun feste **TMDB-IDs** für alle ausgelieferten MCU- und Legacy-Einträge. Dadurch ist das Script nicht mehr von lokalisierten oder je nach Seerr-Version unterschiedlich aufgebauten Suchergebnissen abhängig.
|
|
|
|
Wichtig: Seerr fordert Medien über **TMDB-IDs**, nicht über IMDb-IDs, an.
|
|
|
|
Weitere Korrekturen:
|
|
|
|
- Jellyfin-Medien ohne Provider-ID werden über Titel und Erscheinungsjahr erkannt.
|
|
- Eine fehlende TMDB-ID zählt nicht mehr automatisch als harter Fehler.
|
|
- Nicht auflösbare fehlende Medien erscheinen separat unter `Nicht auflösbar`.
|
|
- Nur wirkliche HTTP-, API- oder Playlist-Probleme erscheinen unter `Fehler`.
|
|
- Die Seerr-Suche versteht als Fallback CamelCase- und snake_case-Antworten.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
mkdir -p /opt/marvel-playlist
|
|
cp marvel_jellyfin_seerr.py marvel.env.example /opt/marvel-playlist/
|
|
cd /opt/marvel-playlist
|
|
cp marvel.env.example marvel.env
|
|
chmod 600 marvel.env
|
|
chmod +x marvel_jellyfin_seerr.py
|
|
nano marvel.env
|
|
```
|
|
|
|
Es werden keine Python-Pakete benötigt.
|
|
|
|
## Upgrade von der ersten Version
|
|
|
|
Die vorhandene `marvel.env` bleibt erhalten. Ersetze nur das Script und lösche optional den alten Suchcache:
|
|
|
|
```bash
|
|
cd /opt/marvel-playlist
|
|
cp marvel_jellyfin_seerr.py marvel_jellyfin_seerr.py.bak
|
|
cp /root/marvel_jellyfin_seerr.py ./marvel_jellyfin_seerr.py
|
|
chmod +x marvel_jellyfin_seerr.py
|
|
rm -f .cache/marvel-playlist/tmdb.json
|
|
```
|
|
|
|
## Erst prüfen
|
|
|
|
```bash
|
|
cd /opt/marvel-playlist
|
|
./marvel_jellyfin_seerr.py \
|
|
--dry-run \
|
|
--request-missing \
|
|
--sync-playlist \
|
|
--profile mcu-complete
|
|
```
|
|
|
|
`--dry-run` verhindert sowohl Seerr-Requests als auch Playlist-Änderungen. Die zusätzlichen Schalter zeigen an, welche Aktionen später ausgeführt würden.
|
|
|
|
## Fehlende Medien anfragen
|
|
|
|
```bash
|
|
cd /opt/marvel-playlist
|
|
./marvel_jellyfin_seerr.py --request-missing --profile mcu-complete
|
|
```
|
|
|
|
## Playlist synchronisieren
|
|
|
|
```bash
|
|
cd /opt/marvel-playlist
|
|
./marvel_jellyfin_seerr.py --sync-playlist --profile mcu-complete
|
|
```
|
|
|
|
## Beides in einem Lauf
|
|
|
|
```bash
|
|
cd /opt/marvel-playlist
|
|
./marvel_jellyfin_seerr.py --request-missing --sync-playlist --profile mcu-complete
|
|
```
|
|
|
|
## Profile
|
|
|
|
- `mcu-complete`: MCU inklusive Defenders-Saga, Agent Carter und One-Shots.
|
|
- `mcu-core`: MCU-Filme und Marvel-Studios-Serien ohne ältere Defenders-/One-Shot-Blöcke.
|
|
- `legacy`: X-Men-, ältere Spider-Man- und Fantastic-Four-Filme als separate Doomsday-Vorbereitung.
|
|
- `all`: Erstellt `mcu-complete` und `legacy` als zwei getrennte Playlists.
|
|
|
|
Die Legacy-Liste bleibt absichtlich separat, weil die Fox-X-Men-Zeitlinien verzweigt sind und sich nicht widerspruchsfrei in eine einzige MCU-Chronologie einordnen lassen.
|
|
|
|
## Optionaler täglicher Cronjob
|
|
|
|
Erst verwenden, nachdem ein manueller Dry-Run und ein manueller schreibender Lauf funktioniert haben:
|
|
|
|
```cron
|
|
17 4 * * * cd /opt/marvel-playlist && /usr/bin/python3 ./marvel_jellyfin_seerr.py --request-missing --sync-playlist --profile all >> /var/log/marvel-playlist.log 2>&1
|
|
```
|
|
|
|
## Jellyfin-Playlist-Fehler `parentFolder`
|
|
|
|
Falls Jellyfin beim Erstellen einer Playlist mit `parentFolder` abbricht, prüfe das Jellyfin-Datenverzeichnis. Bei betroffenen Installationen muss dort ein Ordner `Playlists` mit passenden Eigentümerrechten existieren.
|
|
|
|
## Hinweis zu Sonderzeichen
|
|
|
|
Ab Version `2026.08.03-r3` werden sämtliche URL-Query-Parameter strikt percent-encodiert. Dadurch funktionieren Titel mit Sonderzeichen wie `:`, `&`, `?`, `#`, Apostrophen, Sternchen, Schrägstrichen, Umlauten und Unicode-Zeichen auch mit Seerrs strenger API-Validierung. Leerzeichen werden als `%20` statt `+` übertragen.
|