docker.videokonverter/tizen-app/INSTALL.md
data 99730f2f8f feat: VideoKonverter v3.1 - TV-App, Auth, Tizen, Log-API
TV-App (/tv/):
- Login mit bcrypt-Passwort-Hashing und DB-Sessions (30 Tage)
- Home (Weiterschauen, Serien, Filme), Serien-Detail mit Staffeln
- Film-Uebersicht und Detail, Fullscreen Video-Player
- Suche mit Live-Ergebnissen, Watch-Progress (alle 10s gespeichert)
- D-Pad/Fernbedienung-Navigation (FocusManager, Samsung Tizen Keys)
- PWA: manifest.json, Service Worker, Icons fuer Handy/Tablet
- Pro-User Berechtigungen (Serien, Filme, Admin, erlaubte Pfade)

Admin-Erweiterungen:
- QR-Code fuer TV-App URL
- User-Verwaltung (CRUD) mit Rechte-Konfiguration
- Log-API: GET /api/log?lines=100&level=INFO

Tizen-App (tizen-app/):
- Wrapper-App fuer Samsung Smart TVs (.wgt Paket)
- Einmalige Server-IP Eingabe, danach automatische Verbindung
- Installationsanleitung (INSTALL.md)

Bug-Fixes:
- executeImport: Job-ID vor resetImport() gesichert
- cursor(aiomysql.DictCursor) statt cursor(dict)
- DB-Spalten width/height statt video_width/video_height

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-28 09:26:19 +01:00

157 lines
5 KiB
Markdown

# VideoKonverter - Samsung Tizen TV Installation
Die VideoKonverter TV-App auf einem Samsung Smart TV (Tizen) installieren.
## Voraussetzungen
- Samsung Smart TV mit Tizen OS (ab 2017)
- PC und TV im gleichen Netzwerk
- Samsung Developer Account (kostenlos): https://developer.samsung.com/
- Tizen Studio auf dem PC
## Schritt 1: Tizen Studio installieren
Download: https://developer.tizen.org/development/tizen-studio/download
### Linux (Manjaro/Arch)
```bash
# Installer herunterladen und ausfuehren
chmod +x web-ide_Tizen_Studio_*.bin
./web-ide_Tizen_Studio_*.bin
# Nach Installation: Tools liegen unter ~/tizen-studio/
# Package Manager oeffnen und installieren:
# - Tizen SDK Tools
# - Samsung TV Extensions (Extension SDK Tab)
# - Samsung Certificate Extension (Extension SDK Tab)
```
### Wichtige Pfade nach Installation
```
~/tizen-studio/tools/sdb # Smart Development Bridge (wie adb)
~/tizen-studio/tools/ide/bin/tizen # CLI-Tool
~/tizen-studio/ide/TizenStudio # IDE starten
```
## Schritt 2: Samsung Developer Zertifikat erstellen
Das Zertifikat signiert die App fuer deinen TV. Ohne Zertifikat verweigert der TV die Installation.
1. Tizen Studio IDE starten
2. **Tools > Certificate Manager** oeffnen
3. **"+" klicken** > **Samsung** waehlen (nicht Tizen!)
4. **TV** als Geraetetyp waehlen
5. Samsung Developer Account Daten eingeben
6. Zertifikat wird erstellt und gespeichert
**WICHTIG:** Zertifikat sichern! Bei App-Updates muss das gleiche Zertifikat verwendet werden.
## Schritt 3: TV vorbereiten (Developer Mode)
### Ueber TV-Menue
1. TV einschalten
2. **Apps** oeffnen (Home > Apps)
3. Im Apps-Bereich die Ziffern **12345** eingeben (bei neueren Fernbedienungen evtl. ueber das virtuelle Nummernfeld)
4. Developer Mode **ON** schalten
5. **Host PC IP** eingeben (IP des PCs mit Tizen Studio)
6. TV neustarten
### Alternative (neuere TVs ab 2024/Tizen 8)
Falls der 12345-Trick nicht funktioniert:
- **Einstellungen > Allgemein > System-Manager** nach Developer Mode suchen
- Oder direkt ueber Tizen Studio Device Manager verbinden (siehe Schritt 4)
## Schritt 4: TV verbinden
1. **TV-IP herausfinden:** TV > Einstellungen > Allgemein > Netzwerk > IP-Adresse
2. In Tizen Studio: **Tools > Device Manager** oeffnen
3. **Remote Device Manager** > TV-IP eingeben > Verbinden
4. TV sollte in der Geraete-Liste erscheinen
5. **Rechtsklick auf TV > "Permit to install applications"**
### Oder per Kommandozeile
```bash
# Verbinden
~/tizen-studio/tools/sdb connect <TV-IP>
# Pruefen
~/tizen-studio/tools/sdb devices
```
## Schritt 5: App installieren
### Option A: Ueber Tizen Studio IDE (empfohlen)
1. Device Manager: TV ist verbunden
2. **Rechtsklick auf TV > "Install app"**
3. `VideoKonverter.wgt` auswaehlen
4. Installation laeuft automatisch
### Option B: Per Kommandozeile
```bash
cd /pfad/zu/tizen-app/
~/tizen-studio/tools/ide/bin/tizen install -n VideoKonverter.wgt -t <TV-Name>
```
Der TV-Name wird mit `sdb devices` angezeigt.
### Option C: Docker (ohne Tizen Studio)
Falls Tizen Studio zu aufwaendig ist - das Georift Docker-Image hat alles drin:
```bash
# Generisches WGT installieren (ohne Tizen Studio auf dem PC)
docker run --rm -v $(pwd):/app georift/install-jellyfin-tizen \
<TV-IP> --wgt /app/VideoKonverter.wgt
```
Siehe: https://github.com/Georift/install-jellyfin-tizen
## Schritt 6: App starten
1. App erscheint als **"VideoKonverter"** im Apps-Menue des TVs
2. Beim **ersten Start**: Server-IP eingeben (z.B. `192.168.155.12:8080`)
3. Die IP wird gespeichert - beim naechsten Start verbindet die App automatisch
4. Login mit TV-App Benutzerdaten (erstellt in der Admin-Oberflaeche)
## Wie funktioniert die App?
Die Tizen-App ist nur ein **duenner Wrapper**. Sie macht nichts ausser:
1. Beim ersten Start die Server-Adresse abfragen
2. Weiterleiten auf `http://<Server-IP>/tv/`
3. Ab dann kommt alles vom Docker-Container
**Vorteil:** Bei Software-Updates muss nur der Docker-Container aktualisiert werden.
Die App auf dem TV muss NICHT neu installiert werden.
## Fehlerbehebung
### TV wird nicht gefunden
- Sind PC und TV im gleichen Netzwerk/VLAN?
- Ist Developer Mode auf dem TV aktiviert?
- Firewall auf dem PC deaktiviert/Port 26101 offen?
### Installation schlaegt fehl
- Zertifikat korrekt erstellt? (Samsung, nicht Tizen)
- "Permit to install applications" ausgefuehrt?
- Alte Version erst deinstallieren: `sdb shell 0 vd_appuninstall vkTVApp001.VideoKonverter`
### App startet nicht / weisser Bildschirm
- Server laeuft? `curl http://<Server-IP>:8080/tv/`
- Richtige IP eingegeben?
- Browser-Cache auf TV leeren: App deinstallieren und neu installieren
## Links
- Samsung Developer Portal: https://developer.samsung.com/smarttv/develop
- Tizen Studio Download: https://developer.tizen.org/development/tizen-studio/download
- Samsung TV Quick-Start Guide: https://developer.samsung.com/smarttv/develop/getting-started/quick-start-guide.html
- Jellyfin Tizen (aehnliches Projekt): https://github.com/jellyfin/jellyfin-tizen
- Samsung-Jellyfin-Installer (GUI): https://github.com/Jellyfin2Samsung/Samsung-Jellyfin-Installer