twitch4steamdeck/CLAUDE_PROGRESS.md

Twitch4SteamDeck — Fortschritts-Snapshot

Stand: Ende 2026-04-07 (Session 2). Diese Datei dient als Übergabe zwischen Sessions. Lies zuerst: diese Datei + todo.md + plan.md. Architekturplan-Quelle: C:\Users\andre\.claude\plans\smooth-shimmying-parasol.md (im Repo gespiegelt).

Aktueller Stand: Phase 0–2 abgeschlossen & verifiziert. Phase 3 Code-complete, noch NICHT verifiziert (mpv PATH-Problem beim ersten Start).

---

Bereits abgeschlossen

✅ Phase 0 — Projekt-Skelett

Siehe vorherige Sessions.

✅ Phase 1 — Twitch OAuth Device Code Flow

Siehe vorherige Sessions. End-to-End verifiziert 2026-04-07.

✅ Phase 2 — Twitch Helix-Client + Sidebar-Layout

Siehe vorherige Sessions. End-to-End verifiziert 2026-04-07.

---

🔄 Phase 3 — Streamlink + mpv (Live-Wiedergabe) — Code complete, nicht verifiziert

Neu erstellte Dateien (Session 2, 2026-04-07):

Main-Prozess:

• src/main/playback/types.ts — PlaybackEvent, Quality
• src/main/playback/streamlink.ts — spawnStreamlink() mit resolveStreamlinkBin() (sucht .exe in %LOCALAPPDATA%\Programs\Streamlink\bin\ usw., Fallback streamlink)
• src/main/playback/mpvController.ts — getMpvIpcPath(), MpvController (Named Pipe Win32 / Unix Socket), connect mit Retry, quit(), disconnect()
• src/main/playback/playbackService.ts — orchestriert streamlink + mpv, startLive(), stop(), stopAll(), emittiert 'playback-event'
• src/main/ipc/handlers.ts — erweitert um playback:start-live, playback:stop, playback:event (main→renderer); registerIpcHandlers nimmt jetzt PlaybackService als 3. Arg
• src/main/index.ts — instanziiert PlaybackService, registriert app.on('before-quit', () => playback.stopAll())

Preload + Typen:

• src/preload/index.ts — window.t4sd.playback.{startLive, stop, onEvent} hinzugefügt
• src/renderer/src/types/t4sd.d.ts — PlaybackEvent-Typ + playback-API hinzugefügt

Renderer:

• src/renderer/src/screens/ChannelScreen.tsx — Detail-Screen: Thumbnail/Avatar/Name/Titel/Spiel/ Viewer, Button „▶ Live ansehen", Zustandsanzeige (idle/starting/playing/error), Escape/B → Stop oder Zurück
• src/renderer/src/screens/AppShell.tsx — selectedChannel-State, Routing zu ChannelScreen, onSelectChannel an FollowingScreen weitergegeben
• src/renderer/src/screens/FollowingScreen.tsx — onSelectChannel-Prop verkabelt, onSelect der Karte ruft jetzt onSelectChannel(ch) auf (nicht mehr nur console.log)
• src/renderer/src/styles/global.css — .channel-screen + alle Unter-Klassen ergänzt

Architektur-Entscheidungen in Phase 3:

• Variante 2: streamlink spawnt mpv selbst via --player mpv --player-args "...". Node steuert nur den streamlink-Prozess direkt.
• mpv IPC via Named Pipe (Win32) oder Unix Socket (Linux), verbunden nach spawn im Hintergrund (nicht blockierend, nicht kritisch für MVP). Wird für quit() beim Stop genutzt.
• resolveStreamlinkBin() sucht die .exe unter bekannten Windows-Installationspfaden, da Electron den User-PATH nicht vollständig erbt.

---

Offener Punkt beim Start morgen — mpv PATH-Problem

Was passiert ist:

Streamlink startet (ENOENT behoben via resolveStreamlinkBin()), aber streamlink kann mpv nicht finden, weil mpv nicht im PATH ist, den streamlink von Electron erbt.

Fehlerbild: [streamlink] exit code 1, kein mpv-Fenster.

Wahrscheinlichste Lösung (zuerst probieren):

VS Code (und damit das Electron-Dev-Fenster) neu starten. Nach dem setx PATH ... für mpv muss VS Code neu gestartet werden, damit es den neuen PATH erbt.

1. VS Code schließen
2. VS Code neu öffnen
3. npm run dev
4. Kanal auswählen → "Live ansehen"

Falls das nicht reicht — Fallback:

mpv-Pfad ebenfalls resolven wie streamlink. In streamlink.ts eine resolveMpvBin()-Funktion ergänzen und den vollen Pfad an --player übergeben:

// In streamlink.ts hinzufügen:
function resolveMpvBin(): string {
  if (process.platform === 'win32') {
    const candidates = [
      join(process.env.LOCALAPPDATA ?? '', 'Programs', 'mpv', 'mpv.exe'),
      // shinchiro winget installiert nach: %LOCALAPPDATA%\Microsoft\WinGet\Packages\...
      // Dort nach mpv.exe suchen wenn oben nicht gefunden
    ]
    for (const p of candidates) {
      if (existsSync(p)) return p
    }
  }
  return 'mpv'
}

Dann in spawnStreamlink():

'--player', resolveMpvBin(),   // statt '--player', 'mpv'

Wichtig: where mpv in der Shell ausführen um den exakten Pfad zu kennen, bevor du resolveMpvBin() implementierst.

Falls auch das nicht reicht:

streamlink selbst via --player-args testen ohne --input-ipc-server (vereinfachter Test), um zu isolieren ob das Problem mpv-start oder IPC-Argument ist.

---

Verifikations-Checkliste Phase 3 (noch offen)

• 5 min Live-Stream ohne Werbe-Unterbrechung auf Windows (Dev-Setup)
• Beim Stop: mpv-Fenster schließt sich sauber, streamlink-Prozess terminiert
• Keine Zombie-Prozesse im Task-Manager nach Stop
• Logout/Login und erneutes Starten funktioniert ohne App-Neustart

---

Erste Anweisung morgen an Claude (copy-paste)

„Lies CLAUDE_PROGRESS.md, todo.md und plan.md. Phase 3 ist code-complete. Das mpv PATH-Problem war der letzte offene Punkt — ich habe VS Code neugestartet (oder den Fallback umgesetzt). Sag mir ob der Stream jetzt läuft."

---

Technische Baseline (Sanity-Check)

• Electron 33, electron-vite, TypeScript 5.5, React 18
• streamlink 8.2.1 installiert unter %LOCALAPPDATA%\Programs\Streamlink\bin\streamlink.exe
• mpv v0.41.0 installiert, via setx zum PATH hinzugefügt (VS Code-Neustart nötig!)
• IPC-Pattern: ipcMain.handle → ipcRenderer.invoke → contextBridge → window.t4sd.*
• Main→Renderer Events via webContents.send + ipcRenderer.on

Wichtiges Projekt-Memo

• Bei allen Architekturänderungen plan.md updaten.
• Nach jeder Subaufgabe Checkbox in todo.md setzen und Update hier.
• Dev-Host: Windows. Target: Steam Deck (Linux / Flatpak).
• Nicht mit Speculative Abstractions aufblähen.