mirror of https://github.com/Andre-Bzk/twitch4steamdeck.git synced 2026-11-15 15:43:08 +01:00

Files

T

- Plan und Todo überarbeitet

2026-04-07 21:14:59 +02:00

Twitch4SteamDeck — TODO

Checkboxen-Tracker. Nach jedem erledigten Punkt sofort abhaken und kurzes Update in CLAUDE_PROGRESS.md ergänzen.

Phase 0 — Projekt-Skelett

deviceCodeFlow.ts (request + polling + refresh)
tokenStore.ts (safeStorage-Persistenz)
authService.ts (Lifecycle + EventEmitter)
IPC-Handler + Preload-Bridge
LoginScreen.tsx (QR + Code + Countdown)
App.tsx Routing nach Auth-Status
.env.example
End-to-End-Verifikation durch User (Login mit echter Twitch-App durchführen)
Token-Persistenz prüfen: App-Neustart → bleibt eingeloggt
Logout testen: userData/twitch-tokens.bin wird gelöscht (später)

src/main/twitch/types.ts (Helix-Response-Typen)
src/main/twitch/helixClient.ts (fetch-Wrapper, Auth-Header, Client-ID-Header, Paginierung)
Helix-Endpoints implementieren:
- GET /users (eigener User → user_id cachen)
- GET /channels/followed?user_id=… (paginiert)
- GET /streams?user_id=… (batched, max 100 IDs pro Call)
IPC: twitch:get-followed registrieren (merged live-Status + Avatar)
Preload-API erweitern: window.t4sd.twitch.getFollowed
FollowingScreen.tsx — Karten-Grid mit Live-Indicator, Vorschaubild, Titel, Zuschauerzahl
Spatial-Navigation: eigene Implementierung (Arrow-Keys + Region-Switch Sidebar ↔ Main)
Gamepad-Service: src/renderer/src/input/gamepad.ts (Gamepad-API → Keyboard-Events)
FocusableCard.tsx — Block-Layout, Avatar + Name + Titel + Spiel + Viewer-Badge
AppShell.tsx + Sidebar.tsx — Layout mit linker Navigation (Du folgst / Durchsuchen / Mein Account)
Icons.tsx — inline SVG-Icons (Heart, Compass, User)
BrowseScreen.tsx + AccountScreen.tsx — Platzhalter-Screens mit Logout
End-to-End-Verifikation durch User (2026-04-07: Karten + Tastatur-Nav bestätigt)

User: mpv installieren und im PATH verfügbar machen (winget install mpv oder Binary von mpv.io) — mpv --version muss in Shell funktionieren
User: streamlink installieren (winget install streamlink oder pip install streamlink) — streamlink --version muss funktionieren
User: Kurz manuell testen: streamlink --twitch-disable-ads twitch.tv/<live-channel> best --player mpv → soll ein mpv-Fenster mit Live-Stream öffnen. Wenn das klappt, ist der Pipeline-Baseline verifiziert und wir können im Code darauf aufbauen.

src/main/playback/types.ts — PlaybackState, PlaybackEvent, Quality
src/main/playback/streamlink.ts — spawnStreamlink({channelLogin, quality, oauthToken}), gibt ChildProcess mit stdout-Stream zurück, --twitch-disable-ads, --twitch-api-header=Authorization=OAuth <token>, stderr in Logger
src/main/playback/mpvController.ts:
- Plattform-Weiche: win32 → Named Pipe \\.\pipe\twitch4sd-mpv-<pid>, sonst Unix Socket unter os.tmpdir()
- start(stdin) — spawnt mpv mit --input-ipc-server=<path> --fullscreen --hwdec=auto -
- IPC-Client verbindet mit Retry (100–200 ms Delay nach spawn)
- Commands: pause(bool), seek(sec), quit(), observeProperty(name)
- EventEmitter-Events: 'started', 'time-pos', 'ended', 'error'
src/main/playback/playbackService.ts — bindet streamlink + mpv zusammen, verwaltet currentPlayback: { streamlink, mpv, channelLogin }, räumt beim Stop auf
IPC-Kanäle (in handlers.ts):
- playback:start-live → {channelLogin, quality} → Promise<{playbackId}>
- playback:stop
- playback:event (main → renderer, {kind, payload?})

Preload + t4sd.d.ts erweitern: window.t4sd.playback.{startLive, stop, onEvent}
src/renderer/src/screens/ChannelScreen.tsx — Detail-Screen:
- Hero mit Thumbnail/Avatar + Kanalname + Titel + Spiel + Viewer
- Button „Live ansehen" (default best)
- Quality-Picker als Dropdown/Liste (best, 720p, 480p, audio_only) — MVP optional, kann mit Default best beginnen und später nachgezogen werden
- „Zurück"-Button (B / Escape)
Routing in AppShell.tsx erweitern: selectedChannel: FollowedChannelInfo | null State, wenn gesetzt → ChannelScreen statt FollowingScreen anzeigen
FocusableCard.onSelect → setzt selectedChannel
Spatial-Nav: B-Taste / Escape im ChannelScreen → zurück zu FollowingScreen

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
Logout/Login und erneutes Starten funktioniert ohne App-Neustart