How clvansa/iptv-panel works
IPTV Panel manages channel libraries and ordered playlists, imports remote M3U feeds, and supports stream playback and M3U export. The main user workflow runs from the React dashboard through API calls to Express handlers and Sequelize-backed channel or playlist data. Separate branches cover import enrichment, filtering, playlist editing, stream checks/proxying, and export. Source excerpts and the index support the backend relationships; frontend-to-backend HTTP wiring and some README capabilities are not directly shown, so those links are marked unverified or omitted.
Main entry points: Channel.js Channel Records · app.js Express API · import.service.js M3U Import · Router.jsx Page Router
Components 34
Dashboard
- Page Router
frontend/src/routes/Router.jsx - Channel Pages
frontend/src/pages/Channels.jsx - Channel Forms
frontend/src/pages/AddChannel.jsx - Import Page
frontend/src/pages/ImportPlaylist.jsx - Playlist Pages
frontend/src/pages/PlaylistEditor.jsx - Live Player
frontend/src/components/player/LivePlayer.jsx
API Layer
- Channel API Client
frontend/src/api/channels.js - Playlist API Client
frontend/src/api/playlists.js - Filter API Client
frontend/src/api/filters.js - HTTP Client
frontend/src/api/axios.js - Express API
backend/app.js
Channel Catalog
- Channel Routes
backend/routes/channel.routes.js - Channel Operations
backend/controllers/channel.controller.js - Filter Routes
backend/routes/country.routes.js - Filter Handlers
backend/controllers/country.controller.js - Channel Records
backend/models/Channel.js - MySQL Connection
backend/config/database.js
Playlist Workflows
- Playlist Routes
backend/routes/playlist.routes.js - Playlist Operations
backend/controllers/playlist.controller.js - Playlist Records
backend/models/Playlist.js - Playlist Membership
backend/models/PlaylistChannel.js
Import and Streaming
- Import Routes
backend/routes/import.routes.js - Import Handler
backend/controllers/import.controller.js - M3U Import
backend/services/import.service.js - M3U Parser
backend/utils/parseM3u.js - Metadata Sync
backend/services/syncMetadata.service.js - Country Sync
backend/services/syncCountries.service.js - Stream Checker
backend/services/streamChecker.service.js - Export Routes
backend/routes/export.routes.js - Export Handler
backend/controllers/export.controller.js - M3U Export
backend/services/export.service.js
Other components
- Panel User
- Remote M3U Feed
- Stream Source
Connections 48
- Panel User → Page Router: uses
frontend/src/routes/Router.jsx - Page Router → Channel Pages: routes to
frontend/src/routes/Router.jsx - Page Router → Channel Forms: routes to
frontend/src/routes/Router.jsx - Page Router → Import Page: routes to
frontend/src/routes/Router.jsx - Page Router → Playlist Pages: routes to
frontend/src/routes/Router.jsx - Channel Pages → Channel API Client: calls
frontend/src/pages/Channels.jsx - Channel Forms → Channel API Client: calls
frontend/src/pages/AddChannel.jsx - Import Page → Channel API Client: calls
frontend/src/pages/ImportPlaylist.jsx - Playlist Pages → Playlist API Client: calls
frontend/src/pages/PlaylistEditor.jsx - Channel Pages → Filter API Client: loads filters
frontend/src/pages/Channels.jsx - Playlist Pages → Live Player: renders
frontend/src/pages/PlaylistEditor.jsx - Channel API Client → HTTP Client: uses
- Playlist API Client → HTTP Client: uses
frontend/src/api/playlists.js - Filter API Client → HTTP Client: uses
frontend/src/api/filters.js - HTTP Client → Express API: sends API requests
- Express API → Channel Routes: mounts
backend/app.js - Express API → Playlist Routes: mounts
backend/app.js - Express API → Import Routes: mounts
backend/app.js - Express API → Export Routes: mounts
backend/app.js - Express API → Filter Routes: mounts
backend/app.js - Channel Routes → Channel Operations: dispatches
backend/routes/channel.routes.js - Channel Operations → Channel Records: queries
backend/controllers/channel.controller.js - Channel Operations → Stream Checker: checks streams
backend/controllers/channel.controller.js - Filter Routes → Filter Handlers: dispatches
backend/routes/country.routes.js - Filter Handlers → Channel Records: queries
backend/controllers/country.controller.js - Playlist Routes → Playlist Operations: dispatches
backend/routes/playlist.routes.js - Playlist Operations → Playlist Records: queries
backend/controllers/playlist.controller.js - Playlist Operations → Channel Records: queries
backend/controllers/playlist.controller.js - Playlist Operations → Playlist Membership: updates membership
backend/controllers/playlist.controller.js - Import Routes → Import Handler: dispatches
backend/routes/import.routes.js - Import Handler → M3U Import: invokes
backend/controllers/import.controller.js - M3U Import → Remote M3U Feed: fetches feed
backend/services/import.service.js - M3U Import → M3U Parser: parses feed
backend/services/import.service.js - M3U Import → Channel Records: deduplicates and stores
backend/services/import.service.js - M3U Import → Metadata Sync: synchronizes metadata
backend/services/import.service.js - M3U Import → Country Sync: synchronizes countries
backend/services/import.service.js - Metadata Sync → Channel Records: updates
backend/services/syncMetadata.service.js - Country Sync → Channel Records: updates
backend/services/syncCountries.service.js - Channel Operations → Stream Source: proxies stream
backend/controllers/channel.controller.js - Live Player → Stream Source: plays stream
- Export Routes → Export Handler: dispatches
backend/routes/export.routes.js - Export Handler → M3U Export: generates M3U
backend/controllers/export.controller.js - Export Handler → Playlist Records: loads playlist
backend/controllers/export.controller.js - Export Handler → Channel Records: loads channels
backend/controllers/export.controller.js - M3U Export → Channel Records: reads channels
backend/services/export.service.js - Channel Records → MySQL Connection: uses connection
backend/models/Channel.js - Playlist Records → MySQL Connection: uses connection
backend/models/Playlist.js - Playlist Membership → MySQL Connection: uses connection
backend/models/PlaylistChannel.js