How hcne0/deskflix works
Deskflix is an Electron desktop app for browsing local movie and series libraries and playing them in a custom React player. The main workflow is library selection and scanning, catalog presentation and resume selection, then playback through a local FFmpeg-backed HTTP stream; playback progress is persisted for Continue Watching. The graph includes documented metadata enrichment and player controls. Some IPC handlers and scan details are only partially excerpted, so their relationships are shown only where the excerpts or README support them.
Main entry points: main.cjs Desktop and IPC handlers · Player.jsx Video player · App.jsx Catalog and library UI · preload.cjs IPC bridge
Components 14
React experience
- Catalog and library UI
src/App.jsx - Video player
src/Player.jsx - Audio overdrive
src/Player.jsx - React entry
src/main.jsx
Electron bridge
- IPC bridge
electron/preload.cjs - Desktop and IPC handlers
electron/main.cjs
Media services
- Library scanning
electron/main.cjs - TMDB enrichment
electron/main.cjs - FFmpeg stream server
electron/main.cjs
Persistent state
- Progress and library store
electron/main.cjs
Other components
- Viewer
- FFmpeg process
- TMDB service
- Local media files
Connections 17
- Viewer → Catalog and library UI: browses
- React entry → Catalog and library UI: renders
src/main.jsx - Catalog and library UI → IPC bridge: invokes library APIs
src/App.jsx - Catalog and library UI → Video player: opens playback
src/App.jsx - Video player → FFmpeg stream server: requests stream
src/Player.jsx - Video player → Audio overdrive: routes audio
src/Player.jsx - IPC bridge → Desktop and IPC handlers: invokes IPC handlers
electron/preload.cjs - Desktop and IPC handlers → Library scanning: dispatches scans
electron/main.cjs - Library scanning → Local media files: reads directories
electron/main.cjs - Library scanning → TMDB enrichment: looks up titles
electron/main.cjs - TMDB enrichment → TMDB service: requests metadata
electron/main.cjs - Desktop and IPC handlers → Progress and library store: loads and saves
electron/main.cjs - Desktop and IPC handlers → FFmpeg stream server: serves stream route
electron/main.cjs - FFmpeg stream server → Local media files: reads media
electron/main.cjs - FFmpeg stream server → FFmpeg process: spawns process
electron/main.cjs - IPC bridge → Desktop and IPC handlers: saves playback progress
electron/preload.cjs - Video player → Progress and library store: saves progress via IPC