How 4gray/iptvnator works
IPTVnator is a cross-platform IPTV player. The principal workflow is: a viewer opens the workspace, selects or imports a playlist/provider, the application acquires and stores catalog data, and the viewer browses a channel or VOD item before playing it inline, externally, or through embedded MPV. EPG ingestion and querying, downloads, favorites/history, search, and metadata enrichment are important supporting stages. Some feature implementations are represented by their exact enclosing paths because only partial source excerpts were available.
Main entry points: portal Workspace Shell · operations Catalog Operations · xtream-workspace-route-session.service.ts Xtream Session · stalker-session.service.ts Stalker Session
Components 24
Client Navigation
- Workspace Routes
apps/web/src/app/app.routes.ts - Workspace Shell
libs/portal
Providers & Catalog
- M3U Sources
apps/electron-backend/src/app/events/m3u-source-probe.ts - Xtream Session
libs/portal/xtream/feature/src/lib/xtream-workspace-route-session.service.ts - Stalker Session
libs/portal/stalker/data-access/src/lib/stalker-session.service.ts - Catalog Operations
apps/electron-backend/src/app/database/operations - Search Metadata
apps/electron-backend/src/app/database/operations/content-search.util.ts - TMDB Enrichment
apps/electron-backend/src/app/database/operations/tmdb.operations.ts
Guide & Playback
- EPG Fetching
apps/electron-backend/src/app/events/epg-fetch.service.ts - EPG Parser Worker
apps/electron-backend/src/app/workers/epg-parser.worker.ts - EPG Guide Queries
apps/electron-backend/src/app/events/epg-guide-query.service.ts - Embedded MPV Session
libs/ui/playback/src/lib/embedded-mpv-player/embedded-mpv-session-controller.ts - Embedded MPV Backend
apps/electron-backend/src/app/events/embedded-mpv.events.ts - Stalker VOD Playback
libs/portal/stalker/feature/src/lib/stalker-collection-playback.controller.ts - Playback Context
apps/electron-backend/src/app/services/stalker-playback-context.service.ts
Persistence & Offline
- Catalog Database
apps/electron-backend/src/app/database/schema.ts - EPG Data
apps/electron-backend/src/app/database/schema.ts - Download Actions
libs/portal/downloads/feature/src/lib/download-manager-actions.service.ts - Download Runtime
apps/electron-backend/src/app/events/database/download-runtime.ts - Favorites History
apps/electron-backend/src/app/database/operations/favorites.operations.ts
Other components
- Viewer
- IPTV Provider
- Native MPV
apps/electron-backend/native/src/embedded_mpv_linux.cc - TMDB Service
Connections 25
- Viewer → Workspace Routes: opens workspace
- Workspace Routes → Workspace Shell: loads routes
- Workspace Shell → M3U Sources: imports playlists
- Workspace Shell → Xtream Session: syncs route
- Workspace Shell → Stalker Session: starts session
- M3U Sources → Catalog Operations: imports catalog
- Xtream Session → IPTV Provider: fetches catalog
- Stalker Session → IPTV Provider: authenticates
- Xtream Session → Catalog Operations: loads catalog
- Stalker Session → Catalog Operations: loads catalog
- Catalog Operations → Catalog Database: reads and writes
- EPG Fetching → EPG Parser Worker: starts parsing
- EPG Parser Worker → EPG Data: writes EPG
- EPG Guide Queries → EPG Data: reads EPG
- Workspace Shell → EPG Guide Queries: requests guide
- Embedded MPV Session → Embedded MPV Backend: creates session
- Embedded MPV Backend → Native MPV: controls playback
- Stalker VOD Playback → Playback Context: stores credentials
- Stalker VOD Playback → Embedded MPV Session: starts playback
- Download Actions → Download Runtime: controls downloads
- Download Runtime → Catalog Database: persists state
- Workspace Shell → Search Metadata: searches catalog
- Workspace Shell → Favorites History: updates history
- TMDB Enrichment → TMDB Service: requests metadata
- TMDB Enrichment → Catalog Database: stores enrichment