How chernandezweb/iptv-proxy works
IPTV Proxy accepts client playlist, Xtream API, and stream requests, then serves proxied playlists, metadata, guide data, or media from configured providers. Startup loads configuration and constructs the HTTP server; server routes dispatch to M3U, Xtream, admin, and stream handlers. Provider/filter management and failover are important supporting capabilities. The excerpts establish the main route and handler relationships; unsampled cache and relay details are represented only where their paths are evidenced.
Main entry points: server.go HTTP server · xtreamHandles.go Xtream endpoints · admin.go Admin API · routes.go Route dispatch
Components 16
Startup and configuration
- Process entry
main.go - CLI and config
cmd/root.go - Provider settings
pkg/config/provider.go - Category filters
pkg/config/filters.go
HTTP server and proxy
- HTTP server
pkg/server/server.go - Route dispatch
pkg/server/routes.go - M3U handling
pkg/server/handlers.go - Stream relay
pkg/server/relay.go
Xtream services
- Xtream endpoints
pkg/server/xtreamHandles.go - Xtream client
pkg/xtream-proxy/xtream-proxy.go - Response caches
pkg/server/cache.go
Other components
- Operator
- IPTV client
- IPTV provider
Connections 19
- Operator → CLI and config: configures
README.md - Process entry → CLI and config: executes
main.go - CLI and config → HTTP server: constructs and serves
cmd/root.go - HTTP server → Route dispatch: registers routes
pkg/server/server.go - Route dispatch → M3U handling: routes M3U
pkg/server/routes.go - Route dispatch → Xtream endpoints: routes Xtream
pkg/server/routes.go - IPTV client → Route dispatch: requests
pkg/server/routes.go - M3U handling → IPTV provider: relays media
pkg/server/handlers.go - Xtream endpoints → Xtream client: requests metadata
pkg/server/xtreamHandles.go - Xtream client → IPTV provider: queries API
pkg/xtream-proxy/xtream-proxy.go - Xtream endpoints → IPTV provider: fetches streams and guide
pkg/server/xtreamHandles.go - M3U handling → Stream relay: forwards streams
pkg/server/handlers.go - HTTP server → Provider settings: uses provider settings
pkg/server/server.go - Xtream client → Category filters: filters categories
pkg/xtream-proxy/xtream-proxy.go - Xtream endpoints → Response caches: checks cached responses
pkg/server/xtreamHandles.go - HTTP server → Admin API: registers admin routes
pkg/server/server.go - Admin API → Admin UI: serves interface
pkg/server/admin.go - Admin API → Provider settings: reads and saves
pkg/server/admin.go - Admin API → Category filters: saves filters
pkg/server/admin.go