Plugins
IPTV Checker
Version: 1.26.2901902 |
Author: PiratesIRC | Last Updated: Oct 17 2026, 21:57 UTC |
Check IPTV stream status and quality with ffprobe, then rename, move, restore or delete channels based on the result. Judges a channel by all of its streams, so a working backup never marks it dead.
Downloads
Latest Release
- Download:
iptv-checker-latest.zip - Built: Oct 17 2026, 21:58 UTC
- Source Commit:
06c0d38
Checksums:
MD5: faca88cf2cfb2ace4ed681e9bd75af80
SHA256: dfa15b723017d12efcb0855ca15dffebaac6c2aa30bc286556c01fdc87b31c9e
All Versions
| Version | Download | Built | Commit | MD5 | SHA256 |
|---|---|---|---|---|---|
1.26.2901902 |
Download | Oct 17 2026, 21:58 UTC | 06c0d38 |
faca88cf2cfb2ace4ed681e9bd75af80 | dfa15b723017d12efcb0855ca15dffebaac6c2aa30bc286556c01fdc87b31c9e |
1.26.2831712 |
Download | Oct 10 2026, 17:17 UTC | 25958e3 |
005f5b57f1a352323c2aa74a3e4ed33a | 6c1ded69ed4cbb6c536261682a55e0088a19099ec4a83cb799d2ed94bf2ca377 |
1.26.2561754 |
Download | Sep 19 2026, 14:41 UTC | 507db2c |
6f4528c378c4000896f9453bdb1c790f | c011b8921ff2fa76450889123b068c6e95a2ad68bf5ab3bf381d399a8c768632 |
1.26.2481600 |
Download | Sep 05 2026, 16:22 UTC | 1d17008 |
9a11728804bf3bc8081dc631c77d72fb | 7f86975260fdc2c91095294f5ab4c772c3d0f219cb994fc80ccffbdff0a452a3 |
1.26.2402308 |
Download | Aug 28 2026, 23:25 UTC | f1f0426 |
ea84409f0a8024caf7e809c985fda818 | 4ad182d41de3364ea7e9f98749e0a82c6867188b715f6600e49ae0cc2b02af7d |
1.26.2201040 |
Download | Aug 08 2026, 10:47 UTC | d663a41 |
2170f8d07b055a17b97bf88e63586915 | 0594cf87701f448c5a92c7b2a6ea60e8dda86a70c17f0752493d832c88d56a92 |
1.26.2191412 |
Download | Aug 07 2026, 13:58 UTC | 3f8ef4c |
0b35e1ffe3d599d145714dcfc1688de2 | fdf7428f026975daae8a0b459df9e4f4f39f63c4dad9c9806dc6eb867abaeba5 |
1.26.2191151 |
Download | Aug 07 2026, 12:01 UTC | ad108d3 |
48df2906e8d84ec23039b2e113d46057 | 840acf8faf4618bec26720c3598f12dfc7c31ce20c3a6f23c03e3dde64e88f46 |
1.26.2181303 |
Download | Aug 06 2026, 13:14 UTC | b4efca1 |
c8aace013b4bf304655ea47a5358ad5b | 8bea8385b436510e22ab8adff3ddf7edc6a348ab4fec24b4f1e6ae12b9326d01 |
1.26.1741204 |
Download | Jun 23 2026, 22:27 UTC | 4de0ece |
e16b4dc3bc9953f27fca31ce4f4569af | f55095d46511ecf6f5a759b47d9738c76167690acc52240df14250f23ed53c4c |
Source: Browse Plugin
Metadata: View full manifest
Plugin README
Check IPTV stream status, analyze stream quality, and manage channels based on results
Warning: back up your database first
This plugin renames, moves and can permanently delete channels. Before using it, make a backup of your Dispatcharr database.
What it does
Probes every stream behind your channels with ffprobe, records what it finds, and lets you act on
the result.
It answers three questions per stream, and keeps them apart because acting on the wrong one deletes channels that work:
- Alive. The stream plays. Resolution, framerate, codecs and bitrate are recorded and synced back into Dispatcharr so the channel menu can show them.
- Dead. The stream does not play, or it plays but shows nothing worth watching: a blank picture, a frozen picture, silence, or a fixed-duration placeholder file. Those last four are opt-in.
- Skipped. The checker could not judge it. That covers a provider rate-limit response, a
radio station with no video track, and hosts
ffprobecannot read at all. Skipped is never treated as dead, so nothing destructive touches a stream that was merely throttled.
A channel is judged by all of its streams, never by one of them. Most channels carry a primary and one or more backups, and Dispatcharr fails over between them. A channel is only reported dead when every stream failed, so one dead backup never marks a working channel for deletion.
Other things it does:
- Scheduled checks, including overnight windows that pause at a set time and resume where they left off on the next window.
- An HTML report written to
/config/iptv_checker/report.html(or to/data/iptv_checker/reports/when/configcannot be written), grouped by what you should do about each finding, and optionally emailed through the Newsflasharr plugin. It is one self-contained file that fetches nothing from the internet, so it reads the same in a mail client and on a television browser, and it follows a light or dark theme on its own. - CSV export with a preamble that says what the run did before it says how it was configured, so every run leaves a record. Old exports can be deleted automatically after a number of days you choose.
- Rename, move, restore and delete actions. Only deleting is irreversible, and only that button is red.
- Self-healing: a channel that comes back to life is renamed back and moved to its original group automatically.
Requirements
- Dispatcharr v0.20.0 or newer, with channels and groups already configured.
ffprobein the container, andffmpegas well if you enable blank-screen, frozen-video or silent-audio detection.pytzfor the scheduler, which is normally already present.
docker exec dispatcharr which ffprobe
docker exec dispatcharr which ffmpeg
No API credentials are needed. The plugin runs inside Dispatcharr with direct database access.
Install
- Log in to Dispatcharr and go to Plugins.
- Click Import Plugin and upload the release zip.
- Enable the plugin.
To update, delete the old plugin in the Plugins page, restart the container
(docker restart dispatcharr), then import the new zip. Your settings are preserved.
Quick start
- Set Channel Groups and Channel Groups Mode. Leave the box empty to check every group.
- Click Validate to confirm the plugin can see your groups. It reports how many groups will be checked.
- Click Load Groups, then Start Check.
- Watch View Progress, then read View Results or Email Report.
Documentation
Full user guide covers every setting and button, the detection modes, scheduling and windowed runs, the HTML report and email delivery, and troubleshooting.
Versioning
Calver 1.26.{DDD}{HHMM}, being the UTC day-of-year and UTC hour-minute, matching the Lineuparr,
Channel-Mapparr and EPG-Janitor plugins. Releases before 1.26.1081815 used semver.
Contributing
Issues and pull requests are welcome. When reporting a problem, please include your Dispatcharr
version, the relevant container logs
(docker logs dispatcharr | grep "IPTV Checker"), and the exact error text.
Contribution steps, the CI gates, and how updates reach the Dispatcharr plugin marketplace are in DEVELOPMENT.md.
Disclaimer
This plugin makes bulk changes to your channel database, including permanent deletion when you enable it. Test on a small group first, keep a database backup, and read what an action says it will do before confirming it.
Anonymous usage counts
The Streams Checked and Active Installs badges count every install that leaves the “Share anonymous usage counts” setting (on by default) ticked and runs at least one action or check. When an action or check finishes, at most once an hour, or ten minutes after the last report when a check has just checked streams, the plugin sends this plugin’s Streams Checked total and a random id for this plugin on this install to the plugin author’s counter at plugin-stats.dpas.workers.dev. The server stores that id with the total and the date of the last report. The connection shows the server your public IP address; the server uses it only to limit abuse and does not store it in its database, though when an install first registers it keeps a salted one-way hash of it (of its /64 block for IPv6) for up to three days. Cloudflare, which hosts the server, keeps its own request logs. No names, channels, streams, URLs, providers or settings are sent. The figures are self-reported by installs and capped by the server, not verified. Untick the setting to stop sending; this install’s figures are deleted from the server the next time an action or check finishes after you untick. Details: User Guide.
License
MIT. See LICENSE.