# 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