Open-source IPTV playlist checker, M3U/M3U8 cleaner, XMLTV EPG fixer, and FIFA World Cup 2026 broadcaster guide.
Live Demo · World Cup TV Guide · IPTV Status Index · npm package
English (this README) · 简体中文 · Español · Português · 日本語 · 한국어 · العربية
The easiest way to find official, legal broadcasters and streaming options for every FIFA World Cup 2026 country. No pirated streams. No paid channel lists. No Xtream credentials. We only store metadata — never stream URLs.
| 📊 Metric | Value |
|---|---|
| Countries covered | 61 |
| Official channels | 103 |
| Free-to-air / free-to-stream options | 67 |
| Sample fixtures mapped | 6 |
Quick links:
- 🌐 All countries
- 🇺🇸 United States · 🇨🇦 Canada · 🇲🇽 Mexico
- 🇬🇧 UK · 🇩🇪 Germany · 🇫🇷 France
- 🇧🇷 Brazil · 🇦🇷 Argentina · 🇯🇵 Japan
- 🇦🇺 Australia · 🇮🇳 India · 🇿🇦 South Africa
Downloadable metadata per country: XMLTV · iCalendar · placeholder M3U (no stream URLs).
IPTV Doctor checks your own legal M3U/M3U8 playlist, finds dead IPTV channels, cleans dead streams, fixes XMLTV tvg-id mismatches, and produces shareable HTML, JSON, CSV, and Shields badge reports.
npx iptv-doctor check playlist.m3u --report report.html --json report.json --csv report.csv| Need | Command | Output |
|---|---|---|
| Check playlist | iptv-doctor check |
HTML/JSON/CSV diagnostics and optional badge JSON |
| Remove dead streams | iptv-doctor clean |
Fresh M3U |
| Fix EPG IDs | iptv-doctor epg check/fix |
JSON audit or fixed M3U |
| Render saved diagnostics | iptv-doctor report |
HTML/CSV/badge from JSON |
| Publish badge | iptv-doctor badge |
Shields endpoint JSON |
| World Cup metadata | iptv-doctor worldcup |
XMLTV/iCal/placeholder M3U/HTML guide |
| MCP metadata tools | iptv-doctor mcp |
stdio MCP server |
| Live status pages: |
- https://xyzs996.github.io/iptv-doctor/status-index.html
- https://xyzs996.github.io/iptv-doctor/iptv-playlist-checker.html
- https://xyzs996.github.io/iptv-doctor/m3u-checker.html
- https://xyzs996.github.io/iptv-doctor/world-cup-2026-tv-guide.html
Auto-updated by GitHub Actions every 2 hours for official viewing paths and private M3U health checks. Public outputs never include stream URLs; private source URLs are reduced to host names and short hashes. Star this repo if you want a reusable IPTV status index and playlist health workflow.
| Metric | Value |
|---|---|
| Last updated | 2026-11-15T22:25:25.183Z |
| Source mode | official websites |
| Total entries checked | 212 |
| Online | 161 |
| Slow / warning | 2 |
| Offline | 49 |
| Health score | 76% |
| Countries | 63 |
| Categories | 2 |
| Country | Entry | Status | Latency ms | Host | Checked at |
|---|---|---|---|---|---|
| AU | 7plus Sport | ONLINE | 591 | 7plus.com.au | 2026-11-15T22:25:06.621Z |
| PT | A Bola | ONLINE | 445 | www.abola.pt | 2026-11-15T22:25:04.288Z |
| AU | ABC Sport | ONLINE | 1313 | www.abc.net.au | 2026-11-15T22:25:05.000Z |
| JP | ABEMA | ONLINE | 733 | abema.tv | 2026-11-15T22:24:31.101Z |
| JP | ABEMA Sports | ONLINE | 1186 | abema.tv | 2026-11-15T22:25:06.624Z |
| AE | Abu Dhabi Sports | ONLINE | 1035 | adsports.ae | 2026-11-15T22:24:02.375Z |
| CL | ADN Deportes | ONLINE | 229 | www.adnradio.cl | 2026-11-15T22:25:11.227Z |
| QA | Al Kass | ONLINE | 1343 | www.alkass.net | 2026-11-15T22:24:36.672Z |
| QA | Al Kass Sports | ONLINE | 185 | www.alkass.net | 2026-11-15T22:25:19.013Z |
| PE | América Televisión | ONLINE | 449 | www.americatv.com.pe | 2026-11-15T22:24:34.684Z |
| DE | ARD / Das Erste | ONLINE | 1414 | www.daserste.de | 2026-11-15T22:24:13.540Z |
| SA | Arriyadiyah | ONLINE | 313 | www.arriyadiyah.com | 2026-11-15T22:25:19.014Z |
| MY | Astro Arena | ONLINE | 296 | www.astro.com.my | 2026-11-15T22:25:21.182Z |
| GB | BBC | ONLINE | 71 | www.bbc.co.uk | 2026-11-15T22:24:17.097Z |
| GB | BBC iPlayer | ONLINE | 201 | www.bbc.co.uk | 2026-11-15T22:24:17.098Z |
| GB | BBC Sport | ONLINE | 52 | www.bbc.co.uk | 2026-11-15T22:24:53.502Z |
| FR | beIN SPORTS France | ONLINE | 965 | www.beinsports.com | 2026-11-15T22:24:14.957Z |
| QA | beIN SPORTS MENA | ONLINE | 1986 | www.beinsports.com | 2026-11-15T22:24:34.686Z |
| DE | BILD Sport | ONLINE | 363 | sportbild.bild.de | 2026-11-15T22:25:02.903Z |
| US | Bleacher Report | ONLINE | 319 | bleacherreport.com | 2026-11-15T22:24:52.311Z |
Machine-readable outputs:
Crawlable pages:
Generated from official broadcaster and public sports website metadata. No stream URLs are stored or published.
IPTV Doctor Report
Health Score: 83%
Channel Status Latency Segments Code
FOX OK 430ms 1 OK
FS1 WARN 2800ms 1 WARN_SLOW
Demo Broken FAIL 120ms FAIL_HTTPAuto-updated IPTV status index for official sports and public TV websites. Public outputs never include stream URLs, credentials, or paid channel lists.
| Metric | Value |
|---|---|
| Total entries checked | see badge |
| Countries | see badge |
| Categories | Public Sports, World Cup 2026 |
pnpm install
pnpm --filter iptv-doctor doctor check playlist.m3u --report report.html --json report.json --csv report.csv
pnpm test
pnpm typecheck
pnpm builddocker run --rm -v "$PWD:/work" ghcr.io/xyzs996/iptv-doctor check /work/playlist.m3u --report /work/report.html- uses: xyzs996/iptv-doctor@v1
with:
playlist: playlist.m3u
report: report.html
json: report.json
csv: report.csv
badge: badge.json- Add a channel or country: Use the issue templates to request official broadcaster metadata.
- Report expired/offline sources: Open an issue with the channel name and country.
- Star this repo: It helps more people discover free, legal IPTV tools and keeps the World Cup guide updated.
Do not submit stream URLs, paid channel lists, account credentials, Xtream/Stalker portals, tokenized links, or DRM bypass instructions.
apps/iptv-doctor: flagship CLIpackages/iptv-core: parser, probe engine, diagnostics, clean output, reports, compliance scanpackages/match2epg: EPG generation engine for World Cup metadatapackages/sports-data: tournament and legal viewing metadataapps/worldcup-tv-guide,apps/wc26-mcp-tv,apps/spoiler-free-iptv,apps/public-sports-tv-index: campaign pages and examples
People find this repo by searching for:
iptv playlist checker, m3u checker, m3u8 checker, hls checker, iptv cleaner, m3u cleaner, iptv playlist cleaner, free iptv status index, xmltv epg fixer, epg checker, iptv doctor, github actions iptv health check, iptv status badge, kodi iptv setup, jellyfin iptv, plex iptv, world cup 2026 tv guide, fifa world cup 2026 broadcasters, where to watch world cup 2026, world cup 2026 streaming, world cup 2026 free to air, legal iptv tools, iptv diagnostics, iptv channel checker, playlist validator, stream url checker, hls playlist validator, iptv epg generator, m3u editor, iptv automation.
Q: Does IPTV Doctor provide free IPTV streams or M3U playlists? A: No. IPTV Doctor only checks playlists and websites you already own or that are publicly listed as official broadcasters. We never host, share, or link to unauthorized stream URLs.
Q: Can I use this to check if my IPTV subscription M3U is still working?
A: Yes. Run iptv-doctor check playlist.m3u to detect dead channels, slow hosts, and EPG mismatches.
Q: What is the World Cup 2026 TV guide? A: A searchable directory of official broadcasters and free/paid streaming options for 61 countries, with XMLTV, iCalendar, and placeholder M3U metadata.
Q: Is the status index updated automatically? A: Yes. GitHub Actions refreshes the IPTV status index and World Cup pages on a scheduled basis.
Q: Can I self-host the report on GitHub Pages?
A: Yes. The status-index.yml workflow publishes JSON, CSV, badge, and HTML pages to GitHub Pages.
Q: Does it work with Kodi, Jellyfin, Plex, and VLC? A: Yes. The cleaned M3U and fixed XMLTV outputs are compatible with Kodi, Jellyfin, Plex, VLC, IPTVnator, and any standard IPTV player.
The answers above are short on purpose. These are not — each one opens with a direct answer and then walks the whole thing, including where this project stops:
- How do I check an IPTV M3U playlist with GitHub Actions? — the workflow shape, which parts of a playlist the Action reads, and why the playlist URL stays in Secrets while only the summary is published.
- What is the difference between an IPTV checker, M3U checker, and HLS checker? — what each of the three actually tests, which one catches a malformed entry and which one catches a dead endpoint.
- Can IPTV Doctor help with World Cup 2026 TV guide and public sports channels? — which broadcaster metadata is published per country, what the guide pages carry, and the line this project does not cross.
- IPTV: Internet Protocol television; TV content delivered over IP networks.
- M3U / M3U8: Playlist file formats used by IPTV players and streaming apps.
- HLS: HTTP Live Streaming, an adaptive bitrate streaming protocol by Apple.
- XMLTV: A file format for TV listings and electronic program guides (EPG).
- EPG: Electronic Program Guide; the schedule metadata mapped to channels.
- tvg-id: An XMLTV identifier used to link an M3U channel to its EPG entry.
- EPG fixer: A tool that detects and repairs mismatched
tvg-idvalues between a playlist and a guide. - Status index: A regularly checked table of website or stream endpoint health.
- Placeholder M3U: An M3U file with channel metadata but no actual stream URL.
- Compliance scan: A check that verifies no unauthorized stream URLs are present in outputs.