Profile
Back to NewsBack
GitHub Trending 6 min
Reader Mode
kristofferR/IPTVChecker: A fast desktop app for validating IPTV playlists

kristofferR/IPTVChecker: A fast desktop app for validating IPTV playlists

IPTV Checker icon

IPTV Checker

A fast desktop app for validating IPTV playlists.
Built with Tauri v2 — runs on macOS, Windows, and Linux.

IPTV Checker screenshot

Download


Download for macOS
Apple Silicon · .dmg

Download for Windows
64-bit installer · .exe

Download for Linux
AppImage · x64

Intel Mac, Windows ARM, Linux ARM, .deb/.rpm, or Windows portable? See all files →
Homebrew for macOS/Linux and other package managers are mentioned further down.


Features

Load any playlist

Open M3U files from disk or URL, connect to Xtream Codes or Stalker portal accounts, or batch-load an entire folder of playlists. A sample playlist from iptv-org is included to get started immediately.

See what's actually working

Scans every channel and tells you what's alive, dead, geoblocked, DRM-protected, or audio-only. Uses ffmpeg to capture stream thumbnails and detect codec, resolution, FPS, and bitrate. Flags label mismatches and duplicates automatically.

Results stream in live with an ETA and throughput counter. When the scan finishes, a health report panel slides in with per-group scoring. Pause and resume at any time, or compare results across scan history.

Supports HTTP/HLS, RTSP, and RTMP streams. Route checks through a proxy if needed.

Browse, filter, and export

Click any channel to see its thumbnail, preview it in the built-in player, or open the lightbox to browse screenshots with the arrow keys. Filter by group, status, or regex search. Double-click a channel to play it in VLC, IINA, or whatever you have installed.

Export results as CSV, M3U (alive only, split by group, or renamed), or a full JSON scan log. Export everything, just alive channels, or your current selection.

Catch-up that actually works

Channels that advertise catch-up (catchup/catchup-days in M3U, tv_archive on Xtream) get a chip in the table and a pill in the status bar. Verify tells you which ones are real: quick mode asks each archive for the last hour, full mode also checks how far back the archive is available. Fakes come back with a reason (empty archive, serves the live stream, HTTP error, timeout), filter to them, and export either a playlist of only the working catch-up channels or your list with the fake flags stripped. Verdicts stay within the current playlist session and are cleared when the playlist is reopened or the app restarts.

The Guide view shows the EPG for every channel as one scrollable timeline. Replay a past programme on a catch-up channel, use Play from beginning for one still airing, or choose Play live. Right-click an available archive programme and choose Download… to save it to disk with ffmpeg.

Lightweight and fast

Liquid Glass vibrancy on macOS, platform menus, keyboard shortcuts, dark/light/system theme, and desktop notifications when scans finish. Handles playlists with thousands of channels without breaking a sweat.

Keyboard Shortcuts

  • Arrow Up / Down moves the channel selection so you can step through results quickly.
  • Space opens or closes the screenshot lightbox for the selected channel.
  • S starts a scan when idle, or stops the current scan.
  • Cmd/Ctrl + / opens the full shortcuts dialog in the app.

❤️ Support the project

Enjoying IPTVChecker? Sponsoring its development is a lovely way to say thanks and help keep the project growing.

Sponsor on GitHub</a>

Install

Homebrew

Tap repo: kristofferR/homebrew-tap

Homebrew uses the same cask token on macOS and Linux:

brew install --cask kristofferR/tap/iptv-checker

On macOS, the cask installs IPTV Checker.app into /Applications. If it is already there, use:

brew install --cask --adopt kristofferR/tap/iptv-checker

Arch Linux (AUR)

Package: iptv-checker-gui

yay -S iptv-checker-gui

Uses the system ffmpeg package instead of the bundled sidecar binaries.

All platforms

The buttons above link to the default installer for each OS. Every architecture and package format is attached to each GitHub release:

| Platform | Architecture | Files | |----------|-------------|-------| | macOS | Apple Silicon / Intel | .dmg | | Windows | x64 / ARM | .exe installer or portable .zip | | Linux | x64 / ARM | .AppImage, .deb, .rpm |

Scan from the command line

iptv-checker scan checks a playlist without opening a window, so it also runs on a server with no display, from cron or a systemd timer. It uses the app's saved settings and playlists, and the run appears in the app's scan history.

# A saved playlist, by its name in the app
iptv-checker scan "My Provider"

An M3U file, a folder of playlists, or a URL

iptv-checker scan ~/playlists/channels.m3u iptv-checker scan https://example.com/playlist.m3u

Write the CSV report, a playlist per status and the renamed playlist to a folder

iptv-checker scan "My Provider" --export ~/iptv-exports

Override saved scan settings for one run

iptv-checker scan "My Provider" --skip-screenshots --timeout 5 --concurrency 2

iptv-checker scan --help lists every option. The exit code is 0 when the scan completed, 1 when it failed, 2 for invalid arguments and 130 when it was interrupted, so cron and systemd can alert on a failure. A playlist with no channels counts as a failure, and so does a network outage the scan notices.

A nightly scan from cron:

0 4   * iptv-checker scan "My Provider" --quiet --export /srv/iptv
  • Every run checks the whole playlist again and replaces the previous exports in the folder.
  • Two runs against the same provider compete for its connections, so do not let them overlap. systemd timers never do; with cron, wrap the command in flock -n.
  • On macOS the binary is /Applications/IPTV Checker.app/Contents/MacOS/iptv-checker.
  • On Windows the app has no console, so redirect the output to a file to read it.
  • Saved playlists and settings live in the app's settings.json. On a machine the app never ran on there are none, so pass a file or URL and set what you need with flags.

Building from source

Prerequisites

  • Rust (latest stable)
  • Bun (JavaScript runtime and package manager)
  • ffmpeg + ffprobe — optional but recommended for thumbnails and codec detection

Getting Started

# Clone the repo
git clone https://github.com/kristofferR/IPTVChecker.git
cd IPTVChecker

Install frontend dependencies

bun install

(Optional) Download ffmpeg/ffprobe binaries for your platform

bun run setup:ffmpeg

Run in development mode

bun tauri dev

Building

Linux AppImage builds require patchelf to be available on PATH.

# Production build (creates platform-specific installer)
bun tauri build

Backend Benchmark Harness

Deterministic local scan/check throughput benchmark (mock local HTTP stream server):

# Runs Rust backend benchmark binary
bun run perf:backend-scan -- --channels 2000 --concurrency 16 --timeout-secs 2.0 --payload-kb 600

Outputs JSON with:

  • time_to_first_result_ms
  • throughput_channels_per_sec
  • total_elapsed_ms
  • status buckets (alive, drm, dead, geoblocked, errors)

Project Structure

src/                    Frontend (React + TypeScript)
├── components/         UI components (Toolbar, ChannelTable, FilterBar, etc.)
├── hooks/              React hooks (useScan, useSettings, useScreenshot)
└── lib/                Types, Tauri IPC wrappers, formatting, sort/filter logic

src-tauri/src/ Backend (Rust) ├── engine/ Core logic: scan, parser, checker, ffmpeg, proxy, resume, disk ├── commands/ Tauri IPC commands: playlist, scan, export, settings ├── models/ Data types: Channel, ChannelResult, AppSettings, etc. ├── cli.rs Headless scan command ├── state.rs App state management └── error.rs Error types

Tech Stack

| Layer | Technology | |-------|-----------| | Framework | Tauri v2 | | Backend | Rust (tokio, reqwest, serde) | | Frontend | React 19, TypeScript, Vite 7 | | Styling | Tailwind CSS v4 | | Table | @tanstack/react-virtual | | Icons | lucide-react |

License

MIT

Chat with me