# Jellyfin Server

## Zugang

| Feld | Wert |
|------|------|
| Host | `192.168.178.149` (lokal) / `100.77.105.3` (Tailscale) |
| Port | `8096` |
| Hostname | `debian-jellyfin-homeassistent` |
| OS-User | `michael` / PW: `astral66` |
| Version | 10.9.11 |
| API-Key | `7285b4a8793541648bf156599ae05b43` (App: `homelab-ai`) |
| Admin-User | `admin` |
| Admin-PW | `astral66` |

**SSH-Zugang** (nur aus dem lokalen 192.168.178.x Netz, z.B. via pve3):
```bash
sshpass -p 'astral66' ssh -o StrictHostKeyChecking=no michael@192.168.178.149
```
Von außen via Tailscale nur HTTP API erreichbar (Tailscale SSH erfordert Browser-Authentifizierung).

## Netzwerk / Infrastruktur

```
Internet
  └── Fritz!Box (192.168.178.1)
        ├── Jellyfin-Server  192.168.178.149  (debian-jellyfin-homeassistent)
        ├── NAS/Windows      192.168.178.170  (Share: "Medien")
        ├── Synology NAS     192.168.178.94   (Share: "Filme" = Jellyfin Quelle, Share: "Michael")
        └── pve3             192.168.178.250  (= pve-mu-3, Tailscale: 100.109.101.12)
```

### NAS-Zugriff auf dem Jellyfin-Server

Der Jellyfin-Server mountet den Share `Medien` von **192.168.178.170** (Windows-Maschine) an drei Stellen:

| Mount-Punkt | Zweck |
|-------------|-------|
| `/mnt/nas/` | Haupt-NAS-Zugriff (user michael) |
| `/mnt/nas_filme/` | Gleicher Share, als root gemountet (automount) |
| `/srv/media/` | Gleicher Share, als root gemountet |

**Wichtige Ordner auf dem NAS (192.168.178.170/Medien):**

| Pfad | Inhalt |
|------|--------|
| `/mnt/nas/Recorded TV/` | ~700+ Jellyfin-Quelldateien (`.mp4`) |
| `/mnt/nas/Filme zum nachbearbeiten/` | Staging-Ordner: neue SaveTV-Filme warten hier auf Umbenennung/Einpflege |
| `/mnt/nas/Filme umbenennen Eigangsordner/` | Eingangs-Ordner für Batch-Umbenennung |
| `/mnt/nas/Heimatfilme/` | Private Heimvideos |

### Synology NAS (192.168.178.94)

Auf pve3 (192.168.178.250 / Tailscale 100.109.101.12) gemountet:
```bash
# Zugriff von pve3 (100.109.101.12):
ls /mnt/synology/  # Michael-Share (Michas Datenspeicher)
# enthält u.a.: Filme/, Heimatfilme/, Backups/, Musik/, ...
```

SMB-Shares auf der Synology:
- `Filme` – Jellyfin Quelle (benötigt eigene Credentials)
- `Michael` – Michas Datenspeicher (User: Orbitalo, PW: astral66)
- `Mila` – Milas Datenspeicher

## Bibliotheken

| Name | Typ | Quellpfad (auf Jellyfin-Server) |
|------|-----|-------------------------------|
| Filme | movies | `/srv/media/Recorded TV/` |

Aktuell ~718 Filme im Bestand.

## API-Nutzung

```bash
API_KEY="7285b4a8793541648bf156599ae05b43"
JF="http://100.77.105.3:8096"  # via Tailscale (von pve-hetzner aus)
# oder: JF="http://192.168.178.149:8096"  # lokal

# Anzahl Filme
curl -s "$JF/Items/Counts?api_key=$API_KEY"

# Alle Filme (Name + Pfad)
curl -s "$JF/Items?api_key=$API_KEY&IncludeItemTypes=Movie&Recursive=true&Fields=Name,Path&Limit=1000"

# Film suchen
curl -s "$JF/Items?api_key=$API_KEY&SearchTerm=Matrix&IncludeItemTypes=Movie&Recursive=true"
```

**Erreichbarkeit:** Tailscale-IP `100.77.105.3` ist von pve-hetzner aus direkt nutzbar (kein Hop nötig).

## Save.TV → Jellyfin Workflow

```
Save.TV (Cloud-Recorder)
  └── CT 116 auf pve-hetzner
        └── savetv_auto_download.py  (Cron */30 * * * *)
              → lädt Kinofilme nach /mnt/savetv/ (auf pve-hetzner)
              → 1 Film gleichzeitig, 48h + TID-Jitter nach Aufnahme
        └── savetv_sync.py
              → kopiert Dateien von Hetzner via HTTP-API
              → Ziel: /mnt/nas/Filme zum nachbearbeiten/  (auf NAS 192.168.178.170)
              → Wartezeit: 24h nach Download
  └── Manuell: Umbenennen + in "Recorded TV" verschieben
        → Jellyfin scannt automatisch und nimmt Film auf
```

## Staging-Ordner „Filme zum nachbearbeiten"

**Zugriff:**
```bash
# Von pve3 (100.109.101.12) via pve-hetzner:
sshpass -p 'astral66' ssh michael@192.168.178.149 'ls "/mnt/nas/Filme zum nachbearbeiten/"'

# Vergleich mit Jellyfin (Duplikat-Check):
# 1. JF-Filme holen:
curl -s "http://100.77.105.3:8096/Items?api_key=7285b4a8793541648bf156599ae05b43&IncludeItemTypes=Movie&Recursive=true&Fields=Name&Limit=1000"
# 2. Liste "Filme zum nachbearbeiten" holen (via michael@192.168.178.149)
# 3. Titelnamen normieren (Jahreszahl entfernen, Kleinschreibung) und vergleichen
```

**Stand 06.04.2026:** 53 Filme im Staging-Ordner, davon **17 bereits in Jellyfin** (Duplikate):
- 12 Monkeys, Angel Has Fallen, Bullet Train, Children of Men, Der mit dem Wolf tanzt,
  Die Frau in Blau (2023+2025), Die Spezialistin, Kill the Boss, Mile 22,
  No Turning Back, No Way Up, On the Line, Parker, Salt,
  Stirb langsam, Stirb langsam 2

## Benutzer

| Name | Admin |
|------|-------|
| admin | ja |
| Hans | ja (alt) |
| karsten | nein |
| Holger | nein |
| Peter | nein |
| Klemens | nein |
| michael ec | nein |
| Ralf | nein |
| rolf | nein |
| wilfrid | nein |

## Troubleshooting: Details fehlen / Remote-Zugriff wirkt kaputt

Stand: 2026-05-16

Symptom:
- Filmübersicht ist erreichbar, aber Detailseiten/Filmdetails werden im Client nicht angezeigt.
- Zugriff über Tailscale-IP `100.77.105.3:8096` hängt oder läuft in Timeouts.

Befund vom 2026-05-16:
- Jellyfin selbst war lokal gesund:
  - `http://192.168.178.149:8096/health` -> `Healthy`
  - API `/Items/Counts` lieferte `897` Filme.
  - Beispiel-Film `2 Guns` hatte Beschreibung, Genres, TMDB/IMDB IDs und Bilder.
- Medien-Mounts waren aktiv:
  - `/mnt/nas`
  - `/srv/media`
- Docker-Container `jellyfin` war `healthy`.
- Ursache war Tailscale auf dem Jellyfin-Host:
  - `tailscale ip -4` meldete zuerst `no current Tailscale IPs; state: NeedsLogin`
  - `tailscale status` meldete `Logged out`.
- Nach Re-Login war `100.77.105.3` wieder aktiv und `http://100.77.105.3:8096/health` antwortete wieder `Healthy`.
- Danach waren die Filmdetails im Client wieder sichtbar.

Schnelltest:
```bash
# Von pve3 lokal im LAN:
curl -sS http://192.168.178.149:8096/health

# Von CT 116 / Hausmeister oder einem Tailscale-Host:
curl -sS http://100.77.105.3:8096/health
curl -sS "http://100.77.105.3:8096/Items/Counts?api_key=7285b4a8793541648bf156599ae05b43"
```

Fix:
1. Auf dem Jellyfin-Host Tailscale-Status prüfen:
   ```bash
   tailscale ip -4
   tailscale status --self
   ```
2. Wenn `NeedsLogin` oder `Logged out`: Tailscale neu anmelden.
3. Danach erneut prüfen:
   ```bash
   curl -sS http://100.77.105.3:8096/health
   ```
4. Im Browser Jellyfin hart neu laden oder neu einloggen, falls der Webclient alte kaputte API-Antworten gecacht hat.

Wichtig:
- Fehlende Details bedeuten nicht automatisch kaputte Jellyfin-Datenbank oder fehlende Metadaten.
- Erst lokale API gegen `192.168.178.149:8096` prüfen, dann Tailscale/Cloudflare-Zugriff.
- `systemctl is-active jellyfin` kann irreführend sein, weil Jellyfin hier im Docker-Container läuft. Aussagekräftiger ist:
  ```bash
  docker ps | grep jellyfin
  curl -sS http://127.0.0.1:8096/health
  ```