Antennas
Antennas emulates the HDHomeRun tuner API by translating the Tvheadend API, so Plex, Jellyfin, and Emby DVRs can record and stream live TV from a self-hosted…
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.
24/100 Low
- Maintained
- 0last commit 1664 days ago
- Popular
- 51374 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 404 GB minimum RAM, runs on ARM
- Security check
- 152 serious findings, 16 minor, CI, tests
Security check: 2 serious findings
- Uses form-data 2.3.3, which has a known critical vulnerability (npm)
- Uses koa 2.13.4, which has a known critical vulnerability (npm)
Automated checks on commit 3e2ff71, 2 Nov 2026. Not an audit.
Availability: platform listings confirmed 46 days ago, links checked 53 days ago
- GitHub stars
- 374
- Open issues
- 36
- Last commit
- 2022-05-01
- Latest release
- v4.2.0
- License
- MIT
- Activity
- stale
Checked 20 days ago - source: GitHub (TheJF/antennas)
Resources & Compatibility
Minimum requirements: 4 GB RAM. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- First run Create a config.yml in the config folder with your tvheadend_url (including user:pass), antennas_url, and tuner_count, and create an anonymous user (*) with streaming rights in Tvheadend's user section. source
Fetched 37 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Which config file must Antennas have before starting?
It uses config/config.yml, which can be edited to match your setup; for Docker you can mount a volume at a config path containing that file.
Does Tvheadend need a special account for Antennas to stream?
Yes, create an anonymous user in the Tvheadend users section with streaming rights, using the user name *.
Does the Docker setup fully work with Plex discovery?
Docker can run Antennas, but discovery from Plex is currently not quite working.
Which port should Antennas use for DVR clients?
Expose port 5004 and set ANTENNAS_URL to Antennas on that port, while TVHEADEND_URL points to Tvheadend, typically on port 9981.
Answers sourced from github.com
Community
- /r/CordCutters - Say Goodbye to Your Cable TV Provider! - Reddit (reddit)
- OTA tuner and DVR : r/selfhosted - Reddit (reddit)
- Indoor TV Antenna Recommendations : r/cordcutters - Reddit (reddit)
Collected 53 days ago - public community threads