🆓 Free & Open Source — Always

📺 TV Viewer

Community-Built IPTV Catalogue • Open Source • Free Forever

TV Viewer is a media player. It does not host, broadcast or own any of the streams it lists. The catalogue is built and maintained by users.

How It Works

TV Viewer is powered by its community. Everyone watches, everyone contributes.

📥

Install

Download for Android, Windows, Docker, or build from source on Linux. No account, no sign-up — just install and go.

📺

Watch

Browse thousands of community-contributed streams from around the world. Search, filter, favorite. Enjoy in a clean, ad-free player with EPG when supplied by the source.

🤝

Contribute

Report broken channels, submit new ones, rate stream quality. Your feedback makes the list better for everyone.

What's New

CI.

🔄

CORS Proxy

Server-side stream proxy rewrites HLS manifests so channels play reliably in any browser — no extensions needed.

🐳

Docker Deployment

Run the web interface anywhere with one command: docker run -p 8765:8765 tv-viewer-web

📺

Cast Menu

Cast to Chromecast, AirPlay, Picture-in-Picture, or open in a new tab — all from the player toolbar.

🗺️

Map Channel Browser

Click any country on the interactive map to browse and play its channels in a side panel.

📊

Stream Stats Overlay

Live resolution, buffer health, bitrate, and dropped frames — toggle with the stats button during playback.

Automated Tests

23 API tests validate health, channels, proxy, EPG, favorites, and Docker config before every release.

Everything You Need to Watch Live TV

A full-featured IPTV player built by the community, for the community.

🌍

16,000+ User-Contributed Streams

News, music, lifestyle, regional channels, public broadcasters and documentaries — submitted by users from around the world. Aggregated from 80+ public sources and refreshed daily.

👥

Crowdsourced Quality

Users report broken streams and submit new channels. Community health data ensures you only see what actually works.

📱

Cross-Platform

Apps for Android and Windows. Run from source on Linux. Same channel catalogue everywhere.

🔒

Privacy First

No tracking by default. No account required. Optional anonymous analytics (opt-in only). Honours GDPR data-subject rights. Open source — audit it yourself.

Offline Catalogue

Channel list cached locally — browse offline. Streams themselves still require internet and a working source.

🎨

Beautiful Player

EPG program guide (when supplied by the source), favorites, watch history, parental controls with PIN lock, advanced search with filters, and more.

Help Build the Best Channel List

TV Viewer's channel database is maintained by its users. Here's how the crowdsource model works.

Contribute via the App

The easiest way to help — no GitHub account needed. Just use the app normally and participate when you see something.

  • Tap "Report Broken" on any dead channel
  • Submit new channel URLs you discover
  • Rate stream quality to help others
  • Health data syncs anonymously to the shared database

Contribute via GitHub

For bulk submissions or detailed reports, open an issue with our channel report template.

📺 Request Channels 🔧 Report Broken Channel
👤 User requests "UK channels" via form
🤖 Channel Agent searches public IPTV databases
Health-checked channels added via pull request
📺 New channels available in the next release

TV Viewer in Numbers

Live data from our crowdsourced channel database

Live Channels
Countries
Categories

🌍 Top Countries

Loading…

📺 Top Categories

Loading…

Available on Every Platform

Download once, watch everywhere. All platforms get the same channel database.

📱

Android

Android 7.0+ (API 24). Material Design UI with gesture controls and picture-in-picture.

Download APK
Play Store — coming soon
🪟

Windows

Windows 10/11. Fluent Design dark theme. Requires VLC media player installed.

Download EXE
🐧

Linux

Ubuntu, Debian, Fedora, Arch. Run from source with Python 3.12+ and VLC.

Build Instructions
🐳

Docker / NAS

25 MB Alpine image. Runs on 48 MB RAM — perfect for Synology, QNAP, Unraid, or Raspberry Pi.

Docker Guide

Love TV Viewer? 🍺

TV Viewer is free and always will be. If it makes your day better, consider buying the devs a beer. Every contribution fuels late-night coding sessions.

100% goes to development and server costs. No corporate overhead.

Built in the Open

TV Viewer is MIT licensed. Every line of code is public. Fork it, modify it, learn from it, contribute to it.