SkillAgentSearch skills...

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/iptv

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

79/100

Supported Platforms

Claude Code
Claude Desktop

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.

Substance
30/30
Structure
18/20
Description
15/15
Adoption
7/20
Freshness
15/15

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.

SkillScoreStarsUpdatedFormat
iptv (this skill)by dearbulut7944todayMCP Server
taste-skillby Leonxlnx100118.1k9d agoCLAUDE.md
Agent-Reachby Panniantong100112.9k10d agoCLAUDE.md
hyperframesby heygen-com10086.2ktodayCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.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.

IPTV Nexus

Free TV from around the world — checked every day, with a programme guide, in any app.

Sync & Deploy CI Release License: Unlicense

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 in epg-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

  1. Fork this repository.
  2. Settings → Pages → Source: GitHub Actions.
  3. In config/settings.yml, set project.base_url to your Pages URL.
  4. Run Database Sync, then Sync & Deploy, from the Actions tab.
  5. Optional: deploy the Worker for the play

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars44
CategoryDevelopment
Updated5h ago
Forks20

Languages

TypeScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info