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

5 KiB

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)

# 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

# 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

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:

# 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