Skip to main content

Quick Start

Get Teamarr running and generate your first EPG in minutes

Installation

Docker Compose setup, environment variables, and data persistence

Team Channels

Add teams for dedicated 24/7 channels populated with their schedule

Event Groups

Match IPTV stream groups to real sporting events dynamically

​
What is Teamarr?

Teamarr is an add-on for Dispatcharr that generates enriched EPG for sports channels. It pulls rich sports data from providers (ESPN, TSDB, HockeyTech, MLB Stats) — schedules, venues, records, scores, standings, broadcasts, and more — and uses it to manage your IPTV sports channels in Dispatcharr.

​
Two EPG workflows

Team-based EPG

Persistent channels dedicated to a single team (e.g., “New York Yankees”). The channel exists 24/7 and gets populated with pregame, live game, postgame, and idle filler content from the team’s schedule.

Event-based EPG

Ephemeral channels created for each game from your IPTV provider’s stream groups. Teamarr matches stream names to real events and creates channels around game time, deleting them after the event ends.

​
How it works

Your IPTV stream might say: 
NFL: KC vs PHI
Teamarr matches it to real data and generates: 
Channel: Chiefs vs Eagles - 6:30 PM ET
EPG:     Kansas City Chiefs @ Philadelphia Eagles
         Lincoln Financial Field, Philadelphia, PA
         Chiefs (11-1) vs Eagles (10-2)
         Broadcast: NBC, Peacock

​
Key features

  • 330+ leagues across 13 sports — Football, basketball, hockey, baseball, soccer (240+ leagues via ESPN discovery), cricket, lacrosse, MMA, boxing, rugby, volleyball, Australian football, and softball
  • 194 template variables — Customize channel names and EPG with team records, scores, venues, broadcasts, standings, playoff status, and more
  • Flexible stream matching — Aliases, fuzzy matching, and configurable regex extractors to handle inconsistent IPTV naming
  • Automatic Dispatcharr sync — Creates, updates, and deletes channels with drift detection and self-healing sync
  • Scheduled automation — Cron-based EPG generation and channel lifecycle management

​
What Teamarr doesn’t do

Linear TV channels — Teamarr does not support 24/7 channels like TSN, ESPN, or Sportsnet where game info lives in EPG metadata, not the stream name.Create team channels — Team channels are static and already exist in your IPTV provider. Teamarr only generates EPG for them.Match incomplete stream names — If your IPTV provider doesn’t include enough information in the stream name (e.g., just “NBA 1”), Teamarr cannot match it.

​
Stack

LayerTechnology
BackendPython 3.11+, FastAPI, SQLite (WAL mode)
FrontendReact 19, TypeScript, Vite, Tailwind CSS v4
ProvidersESPN (primary), MLB Stats, HockeyTech, TheSportsDB
DeploymentDocker, port 9195

Build docs developers (and LLMs) love

Get started for freeTalk to us