Nexonic TV Server
A self-hosted IPTV player and Xtream Codes server for free, legal live TV, with real stream checks, an EPG TV guide and Smart TV support.
Nexonic TV Server is a self-hosted IPTV player and Xtream Codes server for free, legal TV. Run it on your own computer to browse thousands of free channels by country, category or language, see which streams work right now, and watch them in the browser or on your Smart TV with apps such as IPTV Smarters and TiviMate.
- 100%local: listens on your own computer
- 0telemetry, tracking or accounts
- EPGTV guide with now and next
- MITfree and open source
Latest release: v2.0.0, with safer redirects, safe XMLTV parsing with size limits, clearer errors in the web app and a more reliable end-to-end check.
What it does
- Worldwide live TV browserSearch by channel, country, language or category, with country flags and A to Z category navigation.
- Real stream checksHTTP status, latency, HLS manifest and segment checks, DRM detection and optional ffprobe probing.
- Channel health centerWorking, unstable, offline and region-restricted counts, with CSV and JSON exports.
- Xtream Codes and M3U serverplayer_api.php, get.php and xmltv.php endpoints, so Smart TV apps can log in to your own computer.
- TV guide (EPG)XMLTV import with now and next listings, parsed safely with size limits.
- Favourites and historyTV series channels, favourites and watch history, all stored locally.
- Offline libraryPlay your own video files from the local offline media folder.
- Bring your own playlistsAdd any M3U URL or upload a file from the Sources page.
Quick start
- Install the requirementsPython 3.10+, Node.js 18+, and optionally ffmpeg for codec and resolution checks.
- Set it upClone the repository and run
bash scripts/setup.shto build the backend and web app. - Start watchingRun
bash scripts/start.shand openhttp://localhost:8000. Default playlists import in the background.
git clone https://github.com/Shahrukhalid/nexonic-tv-server.git then cd nexonic-tv-server. Use the Channel Health page to check which streams work.
Watch on your Smart TV
| Step | What to do |
|---|---|
| 1. Open it to your network | Set NEXONIC_HOST=0.0.0.0 in .env and restart the server |
| 2. Get your login | Open Connect Smart TV in the app for the server URL, username and password |
| 3. Add it to your TV app | Choose Xtream Codes API in IPTV Smarters, TiviMate or a similar app |
| 4. Keep it at home | Stay on your home network and do not forward the port on your router |
Privacy and safety
- Local only by defaultThe server listens on 127.0.0.1, so nothing is exposed until you choose to.
- No telemetryNo analytics, tracking or accounts; your data stays in the local-data folder.
- Unique Smart TV passwordEach install gets a random password you can change in Settings.
- Not an open proxyThe relay only forwards hosts in your catalogue and blocks private and cloud-metadata addresses.
- Family-friendly importsAdult-oriented entries are skipped when playlists are imported.
- Hardened in 2.0Redirects are checked to block SSRF, and XMLTV files are parsed safely with size limits.
Nexonic TV Server does not host any streams. Its default sources are Nexonic IPTV (official broadcaster streams) and the public iptv-org playlists. It does not unlock paid channels, bypass DRM or get around regional restrictions; only watch channels you are entitled to in your country.
Open source
MIT licensed, built with Python (FastAPI) and React. Channel names and logos belong to their owners.
Ready to grow with a digital partner?
Tell us about your business. We will reply with honest advice and a clear plan.