asummoner/tvviewerapp repository overview

⁠TV Viewer Web 📺

Lightweight IPTV streaming web interface with 16,000+ channels. Perfect for NAS devices, home servers, and self-hosted media setups.

🌐 Project Homepage⁠ | 📦 Source Code⁠ | 📋 Changelog⁠

⁠What is TV Viewer?

TV Viewer is a self-hosted web application that aggregates free-to-air IPTV streams from around the world into a beautiful, modern interface. Deploy it on your NAS or any Docker host and watch live TV from any browser — no app installs, no subscriptions, no VLC required.

Why use TV Viewer?

• Zero configuration — launches with 16,000+ channels pre-loaded
• Runs anywhere — Synology, QNAP, Unraid, TrueNAS, Raspberry Pi, any Docker host
• Tiny footprint — under 50 MB RAM, 0.1 CPU core minimum
• Browser-based — works on phones, tablets, smart TVs, laptops
• Privacy-first — no accounts, no tracking, no cloud dependency

⁠Quick Start

docker run -d --name tv-viewer -p 8765:8765 -v tv-viewer-data:/data --restart unless-stopped asummoner/tvviewerapp

Then open http://your-server-ip:8765⁠ in any browser. That's it!

⁠Features

• 🌍 16,000+ live TV channels from 55+ countries
• 🎬 In-browser HLS playback — no VLC or external player needed
• 🔀 Multi-source failover — automatically switches to backup streams
• 📡 Built-in CORS proxy — plays streams that normally block browsers
• 🗺️ Interactive world map — browse channels by country
• 🔤 A-Z sorted channels — easy to find what you want
• ❤️ Favorites with server-side persistence
• 📊 Health tracking — broken channels filtered automatically
• 📺 EPG program guide (Now/Next)
• 🔒 Parental controls with PIN lock
• 🎨 Dark/Light themes — modern responsive UI

⁠Resource Requirements

⁠Supported Architectures

Multi-arch manifest: asummoner/tvviewerapp:latest auto-selects the correct platform.

⁠Docker Compose

services:
  tv-viewer:
    image: asummoner/tvviewerapp:latest
    container_name: tv-viewer
    ports:
      - "8765:8765"
    volumes:
      - tv-viewer-data:/data
    environment:
      - TZ=Asia/Jerusalem
      - SUPABASE_URL=${SUPABASE_URL:-}
      - SUPABASE_ANON_KEY=${SUPABASE_ANON_KEY:-}
    deploy:
      resources:
        limits:
          memory: 128M
          cpus: '0.5'
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8765/api/status')"]
      interval: 60s
      timeout: 5s
      start_period: 30s
      retries: 3

volumes:
  tv-viewer-data:

⁠Data Persistence

Favorites, channel cache, and health data are stored in /data inside the container. Mount a volume to preserve data across container upgrades:

# Named volume (recommended)
docker run -d --name tv-viewer -p 8765:8765 -v tv-viewer-data:/data asummoner/tvviewerapp

# Or bind mount to host directory
docker run -d --name tv-viewer -p 8765:8765 -v /path/to/data:/data asummoner/tvviewerapp

What's persisted in /data:

⁠NAS Installation

⁠Synology (Container Manager)

1. Open Container Manager → Registry → Search asummoner/tvviewerapp
2. Download latest tag
3. Create container: port 8765 → 8765, memory limit 128 MB
4. Start and open http://synology-ip:8765

⁠QNAP (Container Station)

1. Open Container Station → Create → Search asummoner/tvviewerapp
2. Set port mapping: 8765 → 8765
3. Set memory limit: 128 MB
4. Apply and access via browser

⁠Unraid

1. Go to Docker → Add Container
2. Repository: asummoner/tvviewerapp
3. Port: 8765 → 8765
4. Apply

⁠TrueNAS SCALE

1. Apps → Launch Docker Image
2. Image: asummoner/tvviewerapp:latest
3. Port: 8765
4. Save

⁠Environment Variables

⁠API Endpoints

⁠Updating

Your favorites and channel data persist in the /data volume across upgrades:

# Docker Compose (recommended — keeps /data volume intact)
docker compose pull && docker compose up -d

# Manual Docker
docker pull asummoner/tvviewerapp:latest
docker stop tv-viewer && docker rm tv-viewer
docker run -d --name tv-viewer -p 8765:8765 -v tv-viewer-data:/data --restart unless-stopped asummoner/tvviewerapp

⁠Source Code & Documentation

⁠License

MIT