A desktop IPTV player built with Electron and mpv.

Early Development - This project is new and actively evolving. The goal is a dead-simple, low-latency player that balances aesthetics, ease of use, and quality-of-life features. We're constantly fixing bugs, adding features, and improving the experience. Check back often for updates, and feel free to open an issue if you run into problems or have suggestions.

• Live TV with EPG - Browse channels by category with a full program guide
• Movies & Series - Browse your VOD library with poster art and metadata
• TMDB Integration - Suggested, popular, and genre-based browsing for movies and series
• Poster Overlays - Optional rating badges on posters via RPDB
• Multi-source Support - Connect via Xtream Codes API or M3U playlists
• EPG from Multiple Sources - Fetch guide data from your provider or external URLs
• Channel Ordering - Sort channels by provider numbers or alphabetically
• Offline Storage - Channels, EPG, and catalog cached locally for fast browsing

Download the latest release from the Releases page:

Windows SmartScreen may block the app on first run. Click More info → Run anyway to proceed.

Video renders natively inside the app window. No external mpv installation is required for normal use.

If the native renderer fails, the app falls back to system mpv. Install via Homebrew if needed:

brew install mpv

Starting with v0.5.3, macOS builds are code-signed and notarized - the app should open without Gatekeeper warnings. If you're upgrading from v0.5.2 or earlier, you'll need to manually download and install v0.5.3 from the Releases page (auto-update can't transition from unsigned to signed). After v0.5.3, auto-updates will work normally.

If you're on a version older than v0.5.3 and macOS blocks the app, remove the quarantine flag:

xattr -dr com.apple.quarantine /Applications/sbtlTV.app

mpv must be installed separately:

# Ubuntu/Debian
sudo apt install mpv

# Fedora
sudo dnf install mpv

# Arch
sudo pacman -S mpv

• Node.js 20+
• pnpm 10+
• mpv installed

pnpm install
pnpm build
pnpm dev

# Download mpv for bundling (Windows)
bash scripts/download-mpv.sh

# Build for current platform
pnpm dist

# Platform-specific
pnpm dist:win
pnpm dist:mac
pnpm dist:linux

1. Open Settings (gear icon)
2. Go to Sources tab
3. Add your Xtream Codes credentials (server URL, username, password)
4. Click Sync to fetch channels and content

Movie and series metadata comes from The Movie Database. Basic matching works automatically.

For genre browsing and suggested/popular lists, add a TMDB Access Token:

1. Create an account at themoviedb.org
2. Get an API Read Access Token from API settings
3. Add it in Settings → TMDB

This product uses the TMDB API but is not endorsed or certified by TMDB.

Add rating badges to posters with an RPDB API key in Settings → Poster DB.

Enable logging in Settings → Debug for troubleshooting. Logs are saved to your app data folder with automatic rotation.

• Windows: %APPDATA%/sbtlTV
• macOS: ~/Library/Application Support/sbtlTV
• Linux: ~/.config/sbtlTV

This application is a media player only and does not provide any content. Users must provide their own IPTV service credentials from a legitimate provider. The developers are not responsible for how this software is used or for any content accessed through it.

Video playback powered by mpv.

GNU Affero General Public License v3.0