A single-language interface makes the app less usable for part of the audience
and encourages more hardcoded copy as new screens and states are added.
Introducing a shared i18n path with a persisted language preference gives the
UI one consistent way to present text and lowers the risk of partial or
inconsistent localization over time.
The surrounding copy cleanup belongs in the same change because it aligns
existing labels, messages, and settings text with that translation structure
instead of leaving mixed localization approaches in place.
German documentation in CLAUDE.md was a barrier for any contributor or
tool without German language context. English is the project's working
language for code and commits — the docs should match.
README.md (bilingual) received new entries for logout confirmation,
shared types layer, ChapterPanel, and QualityPanel in both EN and DE.
The 170-line keydown handler with three implicit modes and a 13-entry
dep array made it hard to trace a single key press to its effect.
Reading ChannelScreen required mentally holding the chapter-, quality-,
and browse-mode branches simultaneously.
Extracting ChapterPanel, QualityPanel, useChannelKeyHandler, and
playbackKeys establishes explicit mode boundaries: a new reader can
look at the mode name and see exactly which bindings apply without
tracing through nested if-blocks. The shared key dispatch (playbackKeys)
also eliminates the silent divergence between AppShell and ChannelScreen
where the same keys had independent implementations.
German comments had survived the earlier translation pass. Mixing
languages in comments creates inconsistency and makes the codebase
harder to read for non-German contributors.
Chromium evaluates the Fetch API's cache mode before the disk cache
storage decision; XHR request headers and onHeadersReceived patches do
not reliably prevent storage. The old approach silently allowed caching
regardless of the setting.
Moving cache suppression to a custom hls.js NoCacheLoader (Fetch with
cache: 'no-store') also eliminates the CORS preflight that Cache-Control
as a request header was triggering, which lets the main-process CORS
handler drop the applyNoStore branch entirely.
File logging defaulted to always-on meant the log grew silently on every
run with no way to turn it off. Changing the default to error-only and
exposing the toggle in Settings lets users opt in only when debugging.
The logout button previously triggered immediately without warning, making
accidental logouts unrecoverable without re-running the device code flow.
A confirmation step (Ja/Nein, gamepad-navigable) prevents that.
Bug reports from Steam Deck (Flatpak) arrived without any useful context:
no terminal, no log file, no trace of what failed. Silent catches in
helixClient hid quota and token errors entirely. IPC handler exceptions
reached the renderer as rejected promises with no server-side record.
electron-log now writes to a rotating log file (~1 MB, 5 files) that
users can attach to bug reports. All IPC handlers are wrapped in
safeHandle, which logs and re-throws at the boundary. Optional-feature
failures (chapters, profile images, viewer counts) emit log.warn with
enough context to diagnose. A React ErrorBoundary catches render crashes
app-wide and logs them before showing a reload prompt.
German inline comments alongside English identifiers create a language
mismatch that makes the code harder to read for anyone not fluent in
German. All 28 affected comments across 14 files are now in English,
consistent with the rest of the project's written artifacts.
The 12 cross-process data types were manually copied across
src/preload/index.ts and src/renderer/src/types/t4sd.d.ts. A silent
field addition or rename in either file would not produce a compile
error in the other — the divergence only surfaces at runtime.
A shared module makes the compiler enforce consistency. Preload imports
from shared/types and re-exports for downstream consumers. The renderer's
t4sd.d.ts re-exports the same types from shared/types, so all existing
screen imports continue to work without modification.
Both tsconfigs are extended to include src/shared so the module is
reachable from both composite projects.
Duplicate raw string literals across handlers.ts, preload/index.ts made
typos undetectable at compile time and renames a multi-file grep problem.
A single channels.ts now owns all channel names; both files import from it.
Also fixes two bugs found during testing:
- LoginScreen and AccountScreen buttons were not triggerable via gamepad
A-button: synthetic KeyboardEvents are untrusted and don't fire native
button clicks. Added explicit keydown handlers that call the action directly.
- AppShell loading overlay could disappear while hlsPayload was still null
if the playback:event 'started' IPC message arrived before playback:hls-url.
Overlay now stays visible until hlsPayload is set, regardless of playState.
Scattered numeric literals had no names at their use sites, making it
impossible to know whether two identical values were intentionally the
same or coincidentally equal. Moving them to typed constants makes the
relationship explicit and ensures a single edit propagates everywhere.
formatViewers, formatCount, formatDuration, formatDate, formatWatchedAt,
formatTimestamp, and formatViewersFull were duplicated across four files.
Divergence was silent — fixing a rounding edge case or locale string in
one copy left the others stale.
Both components managed identical playback state — HLS payload, play state,
quality panel, error message, videoRef — plus duplicate IPC subscriptions
and duplicate startLive/startVod/stop/getQualities sequences.
A shared hook removes that duplication and makes the two-context architecture
legible at a glance: both components call usePlaybackSession, AppShell with
active: !selectedChannel and ChannelScreen with active: true. The ownership
rule is now visible in two lines instead of requiring a cross-file search.
A mutable ref guarded AppShell's IPC listeners against events fired by
ChannelScreen's playback session. The ref had to be set and cleared in
five separate places, making the control flow hard to follow.
The two contexts are already mutually exclusive at the UI level, so the
guard is unnecessary. Subscribing only when no ChannelScreen is open
expresses the same invariant through React's effect lifecycle instead.
Playback errors in the global overlay (direct-start from Browse/Category/
StreamList screens) were silently discarded — the stream disappeared with
no user feedback. Now shows an error overlay with the streamlink message
and a dismiss hint; hls.js fatal errors use the same path.
Chromium computes disk-cache-size dynamically from free disk space, so
the value differs between runs. The cache index then contains a size that
no longer matches, producing "Invalid cache (current) size" on shutdown.
A fixed 500 MB cap keeps the value stable across restarts.
The cache classification thresholds (500 MB / 1 GB) were designed for an
uncapped cache. With a fixed 500 MB limit, the cache can never enter those
states, leaving dead UI states and unused logic behind.
handleWatchVodFromChapter was identical to handleWatchVod except for an
optional startSeconds argument that the bridge already supports. Merged
into a single function with startSeconds?: number.
openChapterPanel was a wrapper around showChapterPanel whose two branches
both executed the same code. Removed the wrapper; call sites now call
showChapterPanel directly.
Also removes stale mpv references from CLAUDE.md that were superseded by
the hls.js migration commit.
mpv was replaced by hls.js in v0.4.0 but its five build modules
(libass, libplacebo, libXpresent, Lua 5.2, mpv itself) and the
ffmpeg7 patch were never removed — dead weight in every build since.
Chromium's HTTP disk cache accumulates HLS segments indefinitely on
Steam Deck — single-use segments have ~0% cache-hit rate but cause
unbounded SSD writes and disk growth. This wires up a runtime toggle
(default: cache disabled) so the user can control the behaviour without
restarting the app.
- Introduce src/main/prefs/hlsCachePref.ts as a shared mutable so
index.ts and handlers.ts don't form a circular import
- Restructure onHeadersReceived in setupTwitchCors: CORS-bypass and
no-store now run as independent blocks; no-store fires only for HLS
extensions (.m3u8/.ts/.m4s/.aac, path before ?) when the toggle is off
- Add IPC handlers app:get-cache-size, app:clear-cache,
app:set-hls-cache-enabled; wire through preload bridge and t4sd.d.ts
- Extend SettingsContext with hlsCacheEnabled (default false); push
persisted value to main on mount and on every change
- Add "Speicher" section to SettingsScreen with HLS toggle row and
cache-size display + clear button; gamepad-navigable
The Joystick API (/dev/input/js*) numbers buttons depending on driver
and connection type. Xbox One controllers via Bluetooth with a Share
button shifted X from button number 2 to 3, silently breaking the
mapping.
The evdev interface provides standardized BTN_* codes (BTN_SOUTH=A,
BTN_NORTH=X, etc.) that remain consistent across Xbox, PlayStation,
and Nintendo controllers over both USB and Bluetooth.
js* devices remain the discovery path, while /sys/class/input/jsN is
used to resolve the corresponding event* device. If the /sys lookup
fails, JoystickFallbackReader falls back to the old Joystick API.
Quality selection during playback:
- Add getAvailableQualities() in streamlink via --json, sorted by fixed order
- Expose playback:get-qualities IPC channel (handlers, preload, type declarations)
- Add quality panel in PlaybackOverlay:
- Button + dropdown
- Keyboard navigation (X: open, arrows: navigate, Enter: confirm, Escape: close)
- Quality change triggers streamlink restart; VOD resumes at current position
- Available in ChannelScreen (Live + VOD) and AppShell global overlay (Live)
- Add QualityIcon
Chapter panel UX improvements:
- Video no longer pauses when chapter panel opens
- PlaybackOverlay is hidden via conditional render instead
- Remove wasPlayingBeforeChapters state (no longer needed)
- X button seeks to video start when no chapters are found, with hint in panel UI
VOD cards and defaults:
- Show view count with eye icon on VOD cards (matching playback overlay style)
- Change default streamBadgeMode from 'language' to 'both'
- Live streams: show viewer count and current category inline next to LIVE indicator
- VODs: display clapperboard badge, total view count, and chapter-based category
- Chapter-based category updates automatically based on playback position
- Chapters are preloaded on VOD start; fallback category is "Unbekannt" if missing
- Add icons: EyeIcon, GamepadIcon, ClapperboardIcon
New PlaybackOverlay component replaces the old hint bar in ChannelScreen.
The overlay sits as a fullscreen layer above the app during playback:
- Auto-hides after 5 s while playing; stays visible when paused;
reactivated by any gamepad key press or mouse movement
- Center play/pause button, channel avatar, title, LIVE badge
- VOD: seek bar with pointer-capture scrubbing, current time / total duration
- Live: pulsing LIVE indicator instead of seek bar
- Double-tap zones left/right (±10 s) with animated skip feedback
- Gamepad hints in the top bar
- New icons: PlayIcon, PauseIcon, StopIcon in Icons.tsx
- New IPC channel `playback:time-update` (~1 Hz) pushes absolute playback
position from main process to renderer; adds PlaybackTimeUpdate type
and onTimeUpdate bridge in preload + t4sd.d.ts
- PlaybackEvent extended with durationSeconds and isLive fields
On Linux, the primary display resolution is queried and the window is maximized on startup. This ensures a fullscreen experience both on the Steam Deck display and on external monitors/TVs when docked.
Windows/dev behavior unchanged.
- AccountScreen zeigt jetzt Profilbild, Anzeigename und @Login des eingeloggten Twitch-Nutzers (via neuem IPC-Kanal twitch:get-own-user)
- CSS: account__avatar zeigt Profilbild, neue Klassen für identity, name, login und error
- Browser-Gamepad-Pfad unter Linux deaktiviert
- nahezu zeitgleiche identische Eingaben aus mehreren /dev/input/js*-Devices entdoppelt
- doppelte D-Pad-Bewegungen bei Bluetooth-/USB-Controllern verhindert
- ffmpeg-full im Flatpak eingebunden für vollständiges H.264/VAAPI-Decoding
- Trigger-Repeat für L2/R2 deaktiviert, um gestapelte 300s-Seeks zu vermeiden
- fMP4-HLS-Playlists über EXT-X-MAP erkannt
- große fMP4-Seeks nicht mehr per In-Stream-Seek, sondern per Reload einer getrimmten Playlist
- getrimmte Playlists über localhost statt file:// ausgeliefert
- absoluten Playback-Offset eingeführt, damit mehrfaches R2 korrekt weiter vorspult
- B Button ermöglicht, mit der selektierung zurück zum sidemenu zurückzukehren
- Logging Schalter dem Einstellungs Screen hinzugefügt
streamlink.ts — 3 neue mpv-Argumente für VODs
- --demuxer-max-bytes=150M / --demuxer-max-back-bytes=75M — größerer Buffer, verhindert Flush bei Seeks
- --hr-seek=no — Keyframe-only Seeks, zuverlässiger für HLS
mpvController.ts — 2 Änderungen - Relative Seeks jetzt relative+keyframes (statt relative) — konsistent mit seekAbsolute - Neue pollTimePos()-Methode als Fallback wenn observe_property nicht feuert
playbackService.ts — Kerndfix
- playback-restart statt file-loaded für den initialen Resume-Seek — wartet bis der erste Frame dekodiert ist, statt nur auf das Manifest
- Seek-Verify nach 5s — prüft ob der Seek geklappt hat, Retry falls nicht
- Poll-Fallback nach 10s — startet Polling falls time-pos nie über observe_property kommt
- Cleanup in stop() für die neuen Timer/Callbacks
- Zusätzlich Menueinträge Top Streams
- Topstreams DE und EN anzeige filterte Livestreams.
- Einstellung Sidebarbreite und Flaggenbadge (Slider) hinzugefügt.
- Kapitel werden via Twitch GQL API geladen
- Kapitelauswahl als Modal-Overlay zentriert dargestellt
- A-Taste pausiert/setzt VOD-Wiedergabe fort (war: Stop)
- Unter "Du folgst" wurde immer der erste Kanal aufgerufen, unabhängig vom ausgewählten Kanal
- Abbrechen der Wiedergabe auch unter "Durchsuchen" und Top-Stream möglich.
- Seitenmenu um Einstellungen ergänzt
- Sprach-Badge und Flaggen anzeige im Thumbnail des Streams anzeigbar.
- Sprach und Flaggen Einstellungen hinzugefügt.
- Durchsuchen Menu
- Top Live Streams
- Top Kategorie
- Anzeige Zuschaueranzahl getTopGames(), technisch bedingt mit einer gewissen unschärfe zu den tatsächliche Zuschauer der Kategorie
- SQLite-Setup: `src/main/store/db.ts` (better-sqlite3, Migration)
- Lokaler VOD-Verlauf (Resume)
- mpv `time-pos`-Observer schreibt alle ~5s in DB
- Auto-Resume: beim VOD-Start Position aus DB lesen → `--start=<s>`
-Resume-Indikator auf VOD-Karte
- Completed-Indikator (dunkles Overlay + Checkmark)
Andre