Self-hosted IPTV player and Xtream Codes server for free, legal TV
Verify free channels, browse by country and watch on your Smart TV.
What it is
Nexonic TV Server is the desktop and Smart TV companion to Nexonic IPTV, the curated list of official free-to-air channels. Run it on your computer to browse thousands of free channels by country, category or language and see which streams are working right now.
It can also act as an Xtream Codes API and M3U server, so IPTV Smarters, TiviMate or any other Xtream Codes player can log in to your own computer.
Features
Worldwide live TV browser
Search by channel, country, language or category, with country flags and A to Z category navigation.
Real stream checks
HTTP status, latency, HLS manifest and segment checks, DRM detection and optional ffprobe probing. Dead links are flagged, not hidden.
Channel health center
Working, unstable, offline and region-restricted counts, with CSV and JSON exports.
Xtream Codes API and M3U server
player_api.php, get.php and xmltv.php endpoints for Smart TV apps.
TV guide (EPG)
XMLTV import with now and next listings.
Favourites and history
TV series channels, favourites and watch history, all stored locally.
Offline library
Play video files you put in local-data/offline_media/.
Bring your own playlists
Add any M3U URL or upload a file from the Sources page.
Privacy and safety
- Local only by default: the server listens on 127.0.0.1.
- No telemetry, analytics, tracking or account; data stays in local-data/.
- Each install gets a random Smart TV password you can change in Settings.
- Not an open proxy: the relay only forwards hosts in your catalogue and blocks private and cloud-metadata addresses.
- Adult-oriented entries are skipped when playlists are imported.
Quick start
Requirements: Python 3.10+, Node.js 18+, and optionally ffmpeg for ffprobe checks.
Install and start
git clone https://github.com/Shahrukhalid/nexonic-tv-server.git
cd nexonic-tv-server
bash scripts/setup.sh # backend venv, packages, web app build
bash scripts/start.sh # then open http://localhost:8000
The first start imports the default playlists in the background; use the Channel Health page to check streams.
Documentation
Frequently asked questions
What is Nexonic TV Server?
A self-hosted IPTV player and Xtream Codes server for free, legal TV channels. It runs on your own computer, verifies streams and lets you watch on a Smart TV.
Does it provide or host TV channels?
No. It does not host any streams. The default sources are Nexonic IPTV (official broadcaster streams) and the public iptv-org playlists, and you can add your own M3U playlists.
How do I watch on a Smart TV?
Set NEXONIC_HOST=0.0.0.0 in .env and restart, open Connect Smart TV in the app for your server URL, username and password, then choose Xtream Codes API in IPTV Smarters, TiviMate or a similar app. Keep it on your home network and do not forward the port on your router.
Is it safe to run?
It listens on 127.0.0.1 by default, has no telemetry, generates a random Smart TV password per install, and its stream relay is not an open proxy.
Can it unlock paid channels or bypass regional restrictions?
No. It does not unlock paid channels, bypass DRM or get around regional restrictions.
What do I need to run it?
Python 3.10+, Node.js 18+, and optionally ffmpeg for ffprobe codec and resolution checks.
What licence is it under?
MIT. Channel names and logos belong to their owners.
Project links
More projects by Shahrukh Khalid
stark-os
Self-hosted multi-agent social media manager; every post needs your approval.
verilive
In-browser deepfake check for video calls; video never leaves your device.
nexonic-iptv
Free IPTV M3U playlists of legal, officially free live TV channels.
facevision-ai
Local, consent-based face detection, recognition and anonymisation.
nexonic-sentinel
Free GitHub App that triages issues, reviews PRs and merges safe dependency updates.
morphlive
Experimental local camera and voice-effects prototype (goal not achieved).