# Xtream Player (Java + com.sun.httpserver) Self-hosted HTML5 app for Xtream IPTV: - provider settings/login - manual source preload (button `Load sources`) with progress bar - sources are stored in local H2 DB and the UI reads them only through local API - tabs for `Live`, `VOD`, `Series`, and `Custom streams` - search + filtering - EPG (`get_short_epg`) for live channels - playback of Xtream streams and custom URLs ## Requirements - Java 17+ - Maven 3.9+ ## Run ```bash mvn -q compile exec:java ``` The app runs on: - `http://localhost:8080` Optional: change port: ```bash PORT=8090 mvn -q compile exec:java ``` ## Docker (JRE 17) Build image: ```bash docker build -t xtream-player:latest . ``` Run container: ```bash docker run --rm -p 8080:8080 \ -e PORT=8080 \ -v xtream-player-data:/home/app/.xtream-player \ xtream-player:latest ``` ## Notes - Config is stored in `~/.xtream-player/config.properties`. - Preloaded sources (live/vod/series categories + lists) are stored in `~/.xtream-player/library/xtream-sources.mv.db`. - Custom streams are stored in browser `localStorage`. - Some Xtream servers/streams may not be browser-friendly (for example `ts`). `m3u8` is usually better for browsers.