Headendarr

Headendarr is a management layer for TVHeadend that streamlines IPTV channel mapping, EPG aggregation, and playlist filtering.

  • Media Applications
  • Media Servers
  • Tools & Utilities
Headendarr is a management layer for TVHeadend that streamlines IPTV channel mapping, EPG aggregation, and playlist filtering. It acts as a high-performance proxy for M3U and HDHomeRun clients, delivering Plex, Emby, Jellyfin, and Kodi a stable, pre-cached stream. Homelab users running TVHeadend can use it as a central hub for curating large channel lists and smoothing live playback.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

45/100 Fair

Maintained
51last commit 220 days ago
Popular
42118 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
801 GB minimum RAM, runs on ARM
Security check
201 serious finding, 4 minor, CI, tests

Availability: platform listings confirmed today, links checked 38 days ago

GitHub stars
118
Open issues
14
Last commit
2026-04-14
Latest release
v2.0.1
License
Apache-2.0
Activity
stale

Checked 13 days ago - source: GitHub (Headendarr/Headendarr)

Resources & Compatibility

Minimum requirements: 1 GB RAM, 1 GB disk. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Start Headendarr in the background Run docker-compose up -d after your Docker Compose file is ready. This pulls the app image and starts it in detached mode, so it keeps running even after you close the terminal. source
  • Set trusted proxy IPs if using a proxy If a web proxy forwards traffic to Headendarr, define TIC_TRUSTED_PROXY_CIDRS with your proxy's IP range when TIC_TRUST_PROXY_HEADERS=true. Without that, the app can be tricked about which IP is visiting, which can weaken security and IP-based restrictions. source
  • Default login credentials The first login is admin:admin; change the password immediately after your initial sign-in. source

Fetched 38 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What default credentials should I use when first logging into Headendarr?

Use admin:admin for the initial login.

Does Headendarr replace TVHeadend?

No. It is a wrapper around TVHeadend that simplifies configuring TVHeadend for IPTV playlists.

Which client types can use Headendarr as a proxy?

It acts as a proxy for M3U and HDHomeRun clients, supporting Plex, Emby, Jellyfin, and Kodi.

What should I check if streams buffer, stutter, or fail to start?

Check network routing, provider capacity, and stream data integrity.

Answers sourced from github.com, headendarr.github.io

Community

Collected 53 days ago - public community threads