Headendarr
Headendarr is a management layer for TVHeadend that streamlines IPTV channel mapping, EPG aggregation, and playlist filtering.
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
Security check: 1 serious finding
- Uses anyio 3.7.1, which has a known critical vulnerability (PyPI)
Automated checks on commit 0e88a76, 9 Nov 2026. Not an audit.
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
Variants
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
- Reddit (reddit)
- FAQ - forum.headendinfo.com (forum)
- Home - forum.headendinfo.com (forum)
Collected 53 days ago - public community threads