Plugins
IPTV Checker
Version: 1.26.2481600 |
Author: PiratesIRC | Last Updated: Sep 05 2026, 16:21 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: Sep 05 2026, 16:22 UTC
- Source Commit:
1d17008
Checksums:
MD5: 9a11728804bf3bc8081dc631c77d72fb
SHA256: 7f86975260fdc2c91095294f5ab4c772c3d0f219cb994fc80ccffbdff0a452a3
All Versions
| Version | Download | Built | Commit | MD5 | SHA256 |
|---|---|---|---|---|---|
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 |
1.26.1721834 |
Download | Jun 21 2026, 19:40 UTC | 7ae9fe2 |
ed2f2081ffcde94a28229f838beb91db | 280a80ef503627be5ab94c675cb9a757844dea34f4d6daa249d171fc14106dbd |
1.26.1582047 |
Download | Jun 08 2026, 00:13 UTC | 78654d4 |
61646995883517cc4fe9caeec47dffb5 | e25a02db89ace1b05366b2c361f20c56876deabddba59ee3dd8b3817240dced1 |
1.26.1421301 |
Download | May 22 2026, 14:18 UTC | c53b209 |
49d562cb3128c2335d654a82abd93d7f | d6ece367d7f57c3149756d3841d558ccaffc3df0dcf443cb918b923d22c5f03a |
Source: Browse Plugin
Metadata: View full manifest
Plugin README
Dispatcharr IPTV Checker Plugin
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, grouped by what you should do about each finding, and optionally emailed through the Newsflasharr plugin. - CSV export with a full settings preamble, so every run leaves an audit record.
- Rename, move, restore and delete actions, each with its own confirmation.
- 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.ffmpegas 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.
License
MIT. See LICENSE.