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

mvn -q compile exec:java

The app runs on:

• http://localhost:8080

Optional: change port:

PORT=8090 mvn -q compile exec:java

Docker (JRE 17)

Build image:

docker build -t xtream-player:latest .

Run container:

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.