# Headendarr

Headendarr is a management layer for TVHeadend that streamlines IPTV channel mapping, EPG aggregation, and playlist filtering. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1723/headendarr

## Description

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.

## Health score

45/100 (Fair), based on 5 of 5 factors.
- Maintained: 51 (last commit 220 days ago)
- Popular: 42 (118 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 80 (1 GB minimum RAM, runs on ARM)
- Security check: 20 (1 serious finding, 4 minor, CI, tests)

## Security check

1 serious finding: Uses anyio 3.7.1, which has a known critical vulnerability.
Automated checks on commit 0e88a76, 9 Nov 2026. Not an audit.

## Links

- Docker Hub: https://hub.docker.com/r/josh5/headendarr
- Official website: https://headendarr.github.io/Headendarr/
- Unraid: https://ca.unraid.net/apps/headendarr-1jsf4160prrwdy?q=Headendarr
- GitHub: https://github.com/Headendarr/Headendarr

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/1723/headendarr), the self-hosted and open-source app directory.
