iptv
Self-updating IPTV index: 31,000+ free TV channels with live stream health checks, M3U playlists, merged XMLTV EPG, a free JSON API and web player. Plus a Stremio addon, Xtream Codes login, custom playlists with failover, an M3U EPG fixer and an MCP server. Runs on GitHub Actions + Pages.
Install / Use
claude mcp add dearbulut -- npx -y github:dearbulut/iptvIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of iptv
iptv scores 79/100 on our quality scale, 3690th of 4,728 Development & Engineering skills we index.
Its MCP Server is 14 KB long, well organised into 13 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
It has 44 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so iptv is actively maintained.
- It is released under the Unlicense license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
iptv compared with similar skills
All 4 of these similar skills score higher than iptv; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| iptv (this skill)by dearbulut | 79 | 44 | today | MCP Server |
| taste-skillby Leonxlnx | 100 | 118.1k | 9d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.9k | 10d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 86.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install iptv?
- Run
claude mcp add dearbulut -- npx -y github:dearbulut/iptv. The install tabs above show the steps for each supported agent. - Which AI agents does iptv work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is iptv safe to use?
- It is Unlicense-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is iptv still maintained?
- The repository was last updated today, so iptv is actively maintained.
Skill content
View source on GitHubIPTV Nexus
Free TV from around the world — checked every day, with a programme guide, in any app.
Built by BulutWorks · Telegram: @bulutworksdev
IPTV Nexus is an open database of 31,000+ TV channels in 230 countries, with 10,000+ that have a free stream and around 8,000 working at any moment. Every stream is tested twice a day, dead links are retired, and a merged programme guide covers 270,000+ programmes. Watch in the browser, add a playlist to any player, log in from TiviMate or IPTV Smarters, install it in Stremio — or use the data in your own app. Alongside live TV there is a catalogue of free films and series that are in the public domain or under Creative Commons.
Everything runs on GitHub Actions, GitHub Pages and a free Cloudflare Worker. No server, no cost, no account needed.
▶ Open the channel browser · 🎬 Free films · 🛠 Tools · 📖 Setup guides · ⬇ Download the database
Watch
| You use | Add this |
| --- | --- |
| A web browser | dearbulut.github.io/iptv — search, filter, play, check where a channel works |
| VLC, Kodi, Jellyfin, Plex, Channels DVR… | https://dearbulut.github.io/iptv/playlists/country/tr.m3u (any country) or best.m3u — the guide comes with it |
| Your own mix | https://iptv-nexus-xtream.bulutworks.workers.dev/m3u?country=tr,de&category=news&online=1 — or build it on the Tools page |
| TiviMate, IPTV Smarters, XCIPTV, TV boxes | Xtream login — server https://iptv-nexus-xtream.bulutworks.workers.dev, any username and password (username country groups by country) |
| Stremio | https://dearbulut.github.io/iptv/stremio/manifest.json |
| Free films and series | Films page, playlists/vod/movies.m3u and series.m3u — and the VOD / Series sections of the Xtream login and the Stremio addon above |
| An AI assistant (Claude, ChatGPT, Cursor…) | MCP server https://iptv-nexus-xtream.bulutworks.workers.dev/mcp — "which Turkish news channels work right now?" |
Step-by-step instructions for every player: docs/CLIENTS.md.
<!-- PLAYLISTS:START -->| Playlist | Contents | URL |
| --- | --- | --- |
| Best | One stream per channel, best first | https://dearbulut.github.io/iptv/playlists/best.m3u |
| Working only | Only streams that passed the last health check | https://dearbulut.github.io/iptv/playlists/online.m3u |
| Everything | Every stream, including backups | https://dearbulut.github.io/iptv/playlists/index.m3u |
| EPG | Programme guide for every linked channel | https://dearbulut.github.io/iptv/epg/guide.xml.gz |
Per-country, per-category and per-language playlists: PLAYLISTS.md.
<!-- PLAYLISTS:END -->What makes it different
For viewers
- Tested, not just listed. Every stream is probed twice a day for status, resolution, codec and latency. Scores follow a stream's history, so one bad minute doesn't remove it; channels that stop working are retired.
- Where it works. Each channel shows the countries where it plays and where it doesn't, measured from viewers' nearest Cloudflare locations — and a "Check from my location" button.
- Automatic failover. Smart links send you to whichever of a channel's streams answers right now, so a channel survives a dead stream.
- Permanent channel numbers. Numbers never change and are never reused, so favourites and channel order survive every update.
- A guide that lines up. One programme guide, matched to the channel ids in every playlist; country playlists load only their own country's guide.
- Honest status. Channels that geo-block our checker are shown as Regional, not offline; streams a browser can't play say why and offer Open in player.
- Free films and series, legally. Feature films, film noir, sci-fi and horror, comedy, silent cinema, cartoons, open movies and classic TV from the Internet Archive — only titles whose licence is public domain or Creative Commons, each shown with its licence. Nothing is copied: they play from archive.org.
For panel owners and providers
- Fix my playlist. Load any M3U and get it back with
tvg-id, logos and channel numbers filled in, so the guide works. It runs in your browser — the playlist and its credentials are never uploaded. 99.9% correct on 10,000 channels written the way panels write them. - Guide corrections in one line:
config/epg-overrides.yml, with every unmatched guide channel listed inepg-unmatched.json.
For developers
- A free static JSON API with an OpenAPI schema: channels, streams with health, shards by country/category/language, search index, per-channel guide, regional availability.
- A change feed (JSON, Atom) of channels that became or stopped being watchable.
- The whole database as one SQLite file, rebuilt every Sunday: database release.
- An MCP server for AI tools, and an Xtream Codes API, both in one Cloudflare Worker you can deploy in two minutes.
Contribute — no pull request needed
| You want to | Use | What happens | | --- | --- | --- | | Add a stream or a new channel | Add a stream | A bot checks the URL, plays it, matches or creates the channel and adds it — in minutes | | Report a channel that doesn't play | Report a broken stream | Its streams are re-tested; dead ones are hidden for 7 days and tested again | | Remove content you hold the rights to | Takedown request | Removed immediately, then reviewed — see docs/LEGAL.md | | Propose a whole playlist | Add a stream source | Evaluated automatically; a maintainer decides |
Only streams that are free to watch are accepted: official broadcaster streams, FAST channels, public service media. Subscription (reseller panel) links are rejected automatically.
Pull requests that only add lines to data/nexus/ are checked the same way
and merged automatically. Code changes are reviewed by a person — see
CONTRIBUTING.md.
How it works
┌──────────────── data/ ─────────────────┐
nightly sync → │ iptv-org/ 31k channels, 18k streams │
│ nexus/ community streams, channels,│ ← issue forms, PRs, bots
│ corrections, takedowns │
└───────────────────┬────────────────────┘
▼
aggregate → health scan (2×/day) → guide (nightly) → build
▼
GitHub Pages: site · API · playlists · guide · Stremio addon · weekly SQLite
▼
Cloudflare Worker: playlist builder · smart links · Xtream · MCP · regional data
The database
Everything lives in this repository, under data/:
data/iptv-org/— the channel database this project started from: every channel, feed, logo, stream, guide mapping and blocklist entry, one record per line. The Database Sync workflow brings in the day's additions, corrections and removals every night, with a report in the commit — and refuses a mass removal, keeping the last good copy, so an upstream outage never empties the catalogue.data/nexus/— our own data: streams and channels added by the community, corrections, hidden broken streams and takedowns. The sync never touches it, and its records take precedence.
Automation
| Workflow | When | What it does |
| --- | --- | --- |
| Sync & Deploy | every 6 h | Build the catalogue, guide, API, playlists, site and addon; deploy to Pages |
| Health Scan | 2×/day | Probe every stream in 6 parallel shards; update scores; retire dead links |
| EPG Grab | nightly | Scrape each guide site in config/epg-grab.yml into XMLTV |
| Database Sync | nightly | Apply the day's upstream changes to data/; refuse mass removals |
| Discover Streams | nightly | Find new streams in listed sources, probe them, add the ones that work |
| Community | on issue | Process add a stream, broken stream and takedown forms |
| Repository Bot | on issue / PR | Evaluate proposed sources, guide other issues, merge passing data PRs and Dependabot updates |
| Database Dump | Sundays | Publish the database as one SQLite file |
| VOD Catalogue | Mondays | Rebuild the openly licensed films and series from config/vod.yml |
| CI | on push / PR | Typecheck, tests, pipeline smoke test |
Details, schedules and manual controls: docs/AUTOMATION.md.
API
Everything is a static file on a CDN — no key, no rate limit. Files over 32 KB
also come gzipped (.gz).
| Endpoint | Contents |
| --- | --- |
| /api/v1/index.json | Manifest: counts and every endpoint |
| /api/v1/channels.json | All channels with streams, health, numbers, availability |
| /api/v1/channels/{id}.json | One channel in detail |
| /api/v1/by-country/{code}.json · by-category · by-language | Shards |
| /api/v1/search.json | Compact index for client-side search |
| /api/v1/regional.json | Where each channel works, by country |
| /api/v1/changes.json · changes.xml | What became or stopped being watchable |
| /api/v1/vod.json | Free films and series, with licence and permanent numbers |
| /epg/guide.xml.gz · /epg/{country}.xml.gz · /epg/channels/{id}.json | Guide: merged, by country, by channel |
| /playlists/… | M3U playlists — see PLAYLISTS.md |
| /stremio/manifest.json | Stremio addon (live TV, films, series) |
const BASE = 'https://dearbulut.github.io/iptv';
const channels = await (await fetch(`${BASE}/api/v1/by-country/de.json`)).json();
const news = channels.filter((c) => c.availability === 'online' && c.categories.includes('news'));
console.log(news[0].name, news[0].number, news[0].streams[0].url);
Full reference: docs/API.md · schema: openapi.json.
Run your own copy
- Fork this repository.
- Settings → Pages → Source: GitHub Actions.
- In
config/settings.yml, setproject.base_urlto your Pages URL. - Run Database Sync, then Sync & Deploy, from the Actions tab.
- Optional: deploy the Worker for the play
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
118.1kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.9kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
86.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
