selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
antennas logo

Self-host antennas

v4.2.0

DVR proxy for Plex to Tvheadend via HDHomeRun emulation

ReleaseOpen SourceMIT
Updated3 years ago
LanguageJavaScript
Setup difficultyModerate
Stars
374
Port
5004 (HTTP API and HDHomeRun emulation endpoint)
Docker
thejf/antennas
Install with Docker
Antennas web configuration summary page

What is antennas?

Antennas is a JavaScript port of tvhProxy that acts as a DVR emulator for Plex DVR, allowing it to connect to Tvheadend by emulating the HDHomeRun API. It translates Tvheadend's API into the HDHomeRun format that Plex expects. The software can be deployed via Docker containers, pre-built binaries for multiple platforms, or run directly with Node.js. Configuration is done through a config.yml file or environment variables including TVHEADEND_URL, TUNER_COUNT, ANTENNAS_URL, and optional TVHEADEND_STREAM_URL for Docker networking. The project is licensed under MIT and last updated in April 2023. Note that Docker deployment has a known limitation with Plex discovery functionality.

Should you self-host antennas?

antennas scores 47/100 on selfhost.directory (how scoring works) and ranks #71 of 118 in Media Server. It has 374 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is Jellyfin (88/100, 58 737 stars). It scores higher overall, so compare the two before you pick. See antennas vs Jellyfin side by side.

Features

  • Configuration via file or environment variables
  • Docker networking workaroundDocker deployment has known Plex discovery limitation
  • HDHomeRun API emulation
  • Multiple Deployment Options
  • Plex DVR integration
  • Web configuration summary page

antennas README

How to install antennas

Install antennas with Docker

Environment variables
ANTENNAS_URL, TVHEADEND_URL, TUNER_COUNT, TVHEADEND_STREAM_URL

docker run -p 5004:5004 -e ANTENNAS_URL=http://x.x.x.x:5004 -e TVHEADEND_URL=http://replace:me@x.x.x.x:9981 thejf/antennas

Known limitation: Plex discovery not working in Docker

How to configure antennas

  • ANTENNAS_URLPublic URL where Antennas is accessible

    Public URL where Antennas is accessible

  • --configCustom path for config file

    Custom path for config file

  • DEVICE_UUIDOptional device UUID for identification

    Optional device UUID for identification

  • --nologoDisable ASCII art logo for simple text one

    Disable ASCII art logo for simple text one

  • TUNER_COUNTNumber of tuners in Tvheadend

    Number of tuners in Tvheadend

  • TVHEADEND_STREAM_URLOptional stream URL different from Tvheadend URL for private Docker networks

    Optional stream URL different from Tvheadend URL for private Docker networks

  • TVHEADEND_URLPath to Tvheadend setup with username, password, and port

    Path to Tvheadend setup with username, password, and port

antennas releases & version history

More in Media Server

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…