Skip to main content

tvarr

tvarr (pronounced tee-vee-arr) is an IPTV proxy and stream aggregator for home users.

Inspired by the *arr tools (Sonarr, Radarr, etc.), it brings multiple external IPTV streams into one convenient, curated manifest for your favorite M3U8 player.

Pronunciation

tvarr = tee-vee-arr (TV + arr)

What It Does​

Aggregate Streams​

Combine multiple M3U/Xtream sources into unified playlists:

  • Import from anywhere - M3U files, URLs, or Xtream Codes APIs
  • Merge EPG data - XMLTV and Xtream guide data combined
  • Filter and organize - Keep only what you want, organized your way

Proxy and Transcode​

Stream through tvarr for compatibility and control:

  • Passthrough mode - Direct proxy, minimal overhead
  • Transcode on-demand - Convert codecs for device compatibility
  • Hardware acceleration - VAAPI, NVENC, QSV, AMF support
  • Distributed workers - Scale transcoding across multiple machines

Curate Your Experience​

Powerful filtering and transformation:

  • Expression-based rules - Filter channels by name, group, or any field
  • Data mapping - Transform channel metadata (names, logos, groups)
  • Client detection - Serve different quality profiles based on device

Quick Start​

# Using Docker Compose (recommended)
curl -O https://raw.githubusercontent.com/jmylchreest/tvarr/main/deployment/docker/docker-compose.standalone.yml
docker compose -f docker-compose.standalone.yml up -d

# Access the web UI
open http://localhost:8080

Next Steps​

Get Started

Install and run tvarr in 5 minutes

Quickstart Guide

Learn the Basics

Understand sources, proxies, and channels

Core Concepts

Filter Channels

Create rules to curate your streams

Filtering & Rules