121 lines
13 KiB
Markdown
121 lines
13 KiB
Markdown
---
|
||
title: Jellyfin Media Server
|
||
category: systems
|
||
tags: [jellyfin, media, kubernetes, vaapi, swiftfin]
|
||
created: "2026-10-19"
|
||
modified: "2026-10-19"
|
||
---
|
||
|
||
# Jellyfin (Media Server)
|
||
|
||
## Überblick
|
||
Selbst gehosteter Medienserver für die Adult-Szenen-Bibliothek (Kink.com/Series + Erika Lust), Abspielziel AppleTV via **Swiftfin**.
|
||
|
||
| Fakultät | Wert |
|
||
|---|---|
|
||
| Version | `jellyfin/jellyfin:12.2` (Tag gepinnt, nie `latest`) |
|
||
| Namespace | `sabnzbd` (Co-Lokation wegen RWO-Mount der sabnzbd-PVC) |
|
||
| Node-Pin | `rke2-worker-05` (einziger iGPU-Node, `/dev/dri/renderD128`, GID 991, `privileged: true`) |
|
||
| VIP | **10.0.30.209:8096** (Cilium LB-IPAM, Annotation `io.cilium/lb-ipam-ips`) |
|
||
| Config-PVC | `jellyfin-config` 5Gi RWO ceph-hdd-replica |
|
||
| Media-Mount | sabnzbd-PVC **read-only** auf `/media` (= `/config/downloads/media` im SABnzbd-Pod) |
|
||
| Manifeste | `iac-homelab/clusters/main/jellyfin/` + App `clusters/main/apps/jellyfin.yaml` |
|
||
| NetworkPolicy | CNP `jellyfin-lan-only` (world/host/remote-node auf 8096 — VIP-Ingress kommt durch SNAT als `world` an, s. Cilium-Traps) |
|
||
| Admin-Login | 1P-Item **„Jellyfin Login dominik"** (Vault Kubernetes ESO), User `dominik`, IsAdministrator |
|
||
|
||
## Bibliothek
|
||
- Library **„Mediathek"** (`collectionType=homevideos`), Pfad `/media`. Stand **29.10.2026: 215 Videos, 215 NFOs** in 25 Serienordnern (Jellyfin 1:1 = 215 Items, Scan verifiziert) (PureTaboo 42, Deeper 45, KinkUniversity 1, SexAndSubmission 26, TheUpperFloor 18, BratTamer 16, DeviceBondage 13, DungeonSex 13, HogTied 8, TheTrainingOfO 6, ErikaLust 5, He's in Charge 4, Lustery 3, BFTP18/NerdPervert/KinkTestShoots 2, AnalVids/BellesaFilms/BoundGangBangs/BukkakeFest/EnjoyX/GlowingDesire/MajorHotWife/SilkSub/TheLifeErotic 1).
|
||
- **Kollaps-Falle**: Movies-Typ fasst mehrere Dateien pro Ordner zu 1 Film + unsichtbaren Extras zusammen. Szenen-Bibliotheken besser als `homevideos` oder untypisiert anlegen (zeigen jede Datei einzeln; NFO-Parsing identisch).
|
||
- **Zombie-Items-Falle**: Alte Movie-Items auf gleichen Pfaden überleben Library-Delete+Recreate in `jellyfin.db` (pfadbasiertes Keying) und lassen jeden Scan leer laufen („Validating" ohne Enumeration). Heilung: Full-DB-Reset — ArgoCD selfHeal aus, scale 0, `mv /config/data/jellyfin.db* /config/dbbackup-<datum>/`, Wizard-Flag reset, Neu-Bootstrap. Backup: `/config/dbbackup-20261019/` auf jellyfin-config-PVC.
|
||
- **„Other"-Ordner-Falle (29.10.2026)**: Ein Medien-Unterordner namens **`Other`** lässt den Library-Scan dauerhaft bei **84 %** hängen — Endlosschleife im .NET-Prozess (PID 1 verbrennt CPU, **kein** ffmpeg/ffprobe-Subprozess), Item-Zahl bleibt konstant, DB-Zeile bleibt Stub (`RunTimeTicks=null`, `DateLastSaved=null`). Beweisführung: derselbe bekanntermaßen gute Canary-Film hängt in `Other`, wird aber in einem anders benannten Ordner (`Solo`) sofort indexiert → **Ordnername, nicht Dateicontent**. Weder Re-Encode des Videos noch Löschen der DB-Zeile hilft. Fix: Ordner umbenennen/auflösen; Strays in einen bestehenden Serienordner legen. Diagnose-Trick: Task-State `Running` + `CurrentProgressPercentage` eingefroren, `videos=<konstant>`.
|
||
- NFOs (Kodi-Stil, vom SABnzbd-Sorter generiert) werden gelesen: Title/Plot/Genre/Studio/Actors/Year verifiziert. **NFO-Pflicht**: jedes Video hat ein gleichnamiges `.nfo` (Stichprobe 215/215 am 29.10.).
|
||
- Scheduled Tasks „Extract Chapter Images" + „Generate Trickplay Images" + „Migrate Trickplay" haben **leere Trigger** (RO-Media-Mount darf nie beschrieben werden).
|
||
|
||
## API-Fallen (12.2) — Details: Solution Doc s.u.
|
||
1. Auth-Header heißt jetzt **`Authorization: MediaBrowser ...`** (nicht mehr `X-Emby-Authorization` → sonst 400 ArgumentNullException).
|
||
2. `/Startup/User` nimmt `{"Name","Password"}` — Feld `Username` → täuschende 404. **Route funktioniert anonym NUR OHNE Authorization-Header** (mit MediaBrowser-Header trotz korrektem Payload ebenfalls 404!). Vorsicht: Probe-POSTs legen echte Admin-User an; Route acceptiert nur EINEN Startup-User (danach 403). `GET /Startup/User` = DTO-Sonde (zeigt Seed-User `root`).
|
||
3. Bootstrap-Reihenfolge: Configuration → Startup/User → **erst dann** `/Startup/Complete` (sonst Lockout; Recovery via `system.xml` `IsStartupWizardCompleted=false` + Pod-Restart).
|
||
4. Tasks: Trigger-Update `POST /ScheduledTasks/{id}/Triggers`, Ausführen `POST /ScheduledTasks/Running/{id}` (PUT/alte Route → 405; `OPTIONS` zeigt Allow).
|
||
5. Null-Users-Boot seedet automatisch User `root` ohne Passwort (Login trotzdem 401 — ignorierbar).
|
||
|
||
## Swiftfin / AppleTV
|
||
- **UDP-Autodiscovery funktioniert durch den K8s-VIP nicht** → im Client Server MANUELL eintragen: `http://10.0.30.209:8096`, User `dominik`.
|
||
- Transcode: VAAPI auf worker-05 verfügbar (Hardware-Encoder vorhanden, Jellyfin-Transcodierung ungetestet 19.10.).
|
||
|
||
## Betrieb
|
||
- Scan anstoßen: `POST /ScheduledTasks/Running/<scan-id>` (Task-Id via `GET /ScheduledTasks`, Name „Scan Media Library").
|
||
- Neue Medien landen automatisch via SABnzbd-Sorter in `/media/<Serie>/` (Postproc-Skript, CM `sabnzbd-postproc-script`).
|
||
- Bekannte Data-Hygiene-Aufgabe (19.10.): Alt-Salvage-MKVs (~600 MB 720p) liegen neben frischen 1080p/4K-MP4s derselben Szene (8 Paare in DeviceBondage, ~5 GB); Löschung nur nach GO.
|
||
|
||
## Stale MediaStreams nach In-Place-Ersetzung (30.10.2026)
|
||
|
||
Wird eine Mediendatei **unter gleichem Pfad** ersetzt (Transcode/Remux), behält Jellyfin den alten DB-Stand: es meldet weiter den alten Codec und die alte Dateigröße. Der Client bekommt dann DirectPlay mit falschem Codec angeboten und bricht ab (real: Datei war `hevc`, DB sagte `h264 High 4.418 GB` → QuickTime verweigerte).
|
||
|
||
**Fix:** genau ein `POST /Library/Refresh` (HTTP 204), Scan läuft async; danach stimmen `Size` und `MediaStreams` (`hevc Main 1920×1080 ~2.4 Mbit`). Verifikation über `GET /Items?...&Fields=Path,MediaSources,MediaStreams`.
|
||
|
||
**Regel:** Nach jeder In-Place-Ersetzungswelle ein Refresh — **nicht** mehrere parallel (wiederholte POSTs brechen den laufenden Scan ab). Wiederholte Refreshes während eines laufenden Batch sind unbedenklich, weil die Ersetzung atomar per `mv` passiert.
|
||
|
||
## Green-Artefacts auf AppleTV trotz sauberem Profil (01.11.2026)
|
||
|
||
Titel `TheUpperFloor - 2011-10-20 - Aiden Starr …` (HEVC Main 720p, hvc1, yuv420p, bt709) spielte in Swiftfin nicht — grüne Artefakte, Rest der Serie (H.264) problemlos. ffprobe sah **unauffällig** aus; Ursache war **echte Bitstream-Korruption**: volles `ffmpeg -i … -f null -` ergab 31 `CABAC_MAX_BIN`-Warnings. FFmpeg-Softdecoder toleriert das still, Apples HW-HEVC-Decoder artefaktet/grün.
|
||
|
||
**Diagnose-Praxis:** ffprobe reicht nicht — bei Playback-Problemen immer Full-Decode-Scan (`ffmpeg -v error -i FILE -f null -`), Non-CABAC-Zeilen zählen. Doppel-Editlist mit `media_time=-1` war hier Nebenschauplatz (Remux `-c copy -ignore_editlist 1` half nicht — Korruption sitzt in den Frames, nur echter Transcode löst).
|
||
|
||
**Repertoire (in-place Repair):** Original nach `/config/transcode-originals/<case>/` moven → Transcode nach `_hold` (`libx265 preset superfast crf19 -tag:hvc1`, ~55 min für 60-min-720p) → `chown 1000:1000` + atomic `mv` aufs Ziel → Jellyfin-Pod-Restart erzwingt Re-Inspection (Startup-Scan vergleicht Size/Date) → `_hold`-Temp löschen. Falls API-Key vorhanden: `POST /Library/Refresh` statt Restart.
|
||
|
||
**Fallstricke:** (1) fg-ffmpeg >300 s stirbt am Tool-Timeout → halbes MP4 ohne moov; immer `nohup … &` detachen und pollen. (2) Jellyfin-API-Tokens aus `Devices`-Tabelle können widerrufen sein (401 trotz Vorhandensein) — Restart ist der robuste Fallback.
|
||
|
||
## archive.org als Torrent-freie Zweitquelle (31.10.2026)
|
||
|
||
Usenet liefert keine Shibari-/BDSM-Tutorials (nzbindex null; Alternativ-Indizes JS-Walls), TPB nur per Torrent (Veto). **archive.org Advanced Search** (`advancedsearch.php?q=…&output=json`) + **Metadata-API** (`/metadata/<id>`) + Direktdownload (`/download/<id>/<file>`) lieferten 28 Tutorial-Videos (2,73 GB): BDSM-Skills-Serie, BDSM 101, Mistress Clarissa's Bondage 101 u. a. — alle h264-MP4, AppleTV-Direct-Play.
|
||
|
||
- **Ablage:** `/media/Tutorials/` (eigener Ordner, 28 Items — kein generischer Sammelordner).
|
||
- **Throttle-Falle:** archive.org drosselt pro Verbindung auf ~130 KB/s; sequenziell unbrauchbar. Lösung: **Range-Chunking** (4-MB-Chunks, 32 parallel/Datei, 3 Dateien gleichzeitig) → 1,4 GB in ~8 min.
|
||
- **Integration:** tar-Stream via `kubectl exec -i` in die PVC, `chown 1000:1000`, **ein** `POST /Library/Refresh`, Item-Delta +28 verifiziert. `.hevc_*`-Temps im FS zählen nicht (Jellyfin ignoriert sie absichtlich).
|
||
- Details: `docs/solutions/integrations/2026-10-31-archive-org-tutorial-harvest.md`
|
||
|
||
## StashDB-Metadaten-Pipeline (01.11.2026)
|
||
|
||
Bibliothek nach Studio/Serie kategorisiert + Original-Beschreibungen ersetzt die 475 Boilerplate-NFOs.
|
||
**Crew:** `dschoen`; API-Key in 1Password-Vault **Hermes** (Item *StashDB API Key*), lokal `/tmp/stashdb_key`.
|
||
|
||
### API
|
||
- Endpoint `https://stashdb.org/graphql`, Header **`ApiKey: <JWT>`** (kein Bearer, kein Cookie). `me{ name }` als Auth-Beweis.
|
||
- Der Key ist ein JWT (`{"sub":"APIKey"}`) — funktioniert unabhängig vom Browser-Login.
|
||
|
||
### Matching-Strategie (3 Stufen, 439/506 = 87 % Trefferquote)
|
||
1. `queryScenes` mit `studios:EQUALS` + `date:EQUALS` — eindeutig, höchster Score (Feld `release_date` ist `YYYY-MM-DD`).
|
||
2. Studio + Titeltext.
|
||
3. **Performer-ID** (`performers: {modifier: INCLUDES}`) für undatierte Dateien.
|
||
|
||
### Fallstricke (alle verifiziert)
|
||
- **`searchStudio` ist token-basiert:** „DeviceBondage" → 0 Treffer, „Device" → *Device Bondage*. CamelCase splitten und mit Einzelwort probieren, sonst bleiben ganze Studio-Familien (Kink-Sites) ungematcht.
|
||
- **`performers` akzeptiert kein `EQUALS`** — Serverfehler *„unsupported modifier EQUALS for scene_performers.performer_id"*. Nur **`INCLUDES`** liefert Szenen.
|
||
- **`text` durchsucht nur Titel**, nicht Darsteller und nicht Description. Cast-Suche geht ausschließlich über `searchPerformer` → Performer-ID.
|
||
- Score-Gate: akzeptieren nur wenn **Studio ODER Datum** passt — sonst rutschen Fremd-Studios durch (Textsuche liefert 30 Treffer über alle Studios).
|
||
|
||
### Schreiben
|
||
- **Jellyfin-Update:** `POST /Items/{id}` mit **vollem DTO** (nicht PATCH): `Overview`, `Studios[{Name}]`, `Tags[]`, `PremiereDate`, `ProductionYear`, `People[{Name,Type:Actor|Director}]`, `Genres`. Antwort **204**, Read-Back bestätigt.
|
||
- **Collections** (Kategorisierung nach Studio/Serie): `POST /Collections?name=<Brand>&ids=a,b,c` → `{Id}`; Nachfüllen via `POST /Collections/{id}/Items?ids=…`. 31 Boxsets, 439 Items.
|
||
- **Pfad-Mapping:** Jellyfin sieht `/media/<Brand>/…`, SAB-Pod `/config/downloads/media/<Brand>/…` — Prefix normalisieren, sonst 0 Treffer trotz 504 Items.
|
||
- **NFO:** Kodi-`<movie>`-XML mit `<uniqueid type="stashdb">`, Plot im Original-Englisch, `<actor>`, `<tag>`, `<studio>`; per `tar` + `kubectl cp` in die PVC (nicht Datei-für-Datei).
|
||
|
||
### Rest
|
||
67 ohne Match: 28 Tutorials (nicht in StashDB) + undatierte Einzelfälle. 7 Matches haben leeres `details`-Feld bei StashDB (Titel/Cast/Datum gesetzt, Plot fehlt). Diese 67 sind am 01.11. mit Tag **`nosdb`** markiert (zweiter Anlauf inkl. Performer-Recovery brachte **0** weitere Treffer) — sie werden nicht mehr abgefragt, außer mit `--retry`.
|
||
|
||
### Automatisierung für Neuzugänge (01.11.2026)
|
||
- **Enricher:** `~/workspace/media_meta/stashdb_enrich.py` — idempotent; nimmt Jellyfin-Items **ohne** Tag `StashDB`/`nosdb`, matcht (3 Stufen inkl. Performer-Recovery), schreibt NFO + `POST /Items/{id}`, hängt in die Brand-Collection, markiert Nicht-Treffer mit `nosdb`.
|
||
- **Wrapper:** `~/workspace/media_meta/run_enrich.sh` — lädt `~/.hermes/secrets/media_meta.env` (JF-Token, 600) und holt den StashDB-Key via `op read 'op://Hermes/xsjfcmeo23rgleyu2xovvkb3aq/credential'`. Kein Key im Repo, kein `/tmp`-Cache nötig.
|
||
- **Cron:** Job `7264208b70b0` (*StashDB-Metadaten für Neuzugänge*), `0 */6 * * *`, `no_agent`, Skript `~/.hermes/scripts/media_meta_nightly.sh` → stdout **leer wenn nichts passiert** (Watchdog-Muster), Log `~/workspace/media_meta/enrich.log`.
|
||
- **Nicht** im Sorter (ConfigMap `postproc-scripts`) verankert: Sorter-Änderungen laufen über GitOps, und ein Pod-Rollout killt laufende Transcodes. Der Cron läuft host-seitig, deployt NFOs per `tar`+`kubectl cp` und braucht keinen Rollout.
|
||
- Idle-Lauf = **0 s** (alle Items getaggt), Voll-Lauf mit 67 Kandidaten ≈ 160 s.
|
||
|
||
## Related Solution Docs
|
||
- `docs/solutions/integrations/2026-10-19-jellyfin-12-bootstrap-api-breaking-changes.md`
|
||
- `docs/solutions/bug-fixes/2026-10-19-cilium-networkpolicy-four-traps.md`
|
||
|
||
## Verwandte Wiki-Seiten
|
||
- [[systems/sabnzbd]] — Downloader, Sorter, Media-PVC-Owner
|
||
- [[systems/rke2-kubernetes]] — Cluster, LB-IPAM
|
||
- [[reference/ip-map]]
|