TVHProxy

TVHProxy is a lightweight proxy that exposes the channels and electronic program guide (EPG) data of a running TVHeadend instance through a minimal…

  • Media Servers
  • Network Services
TVHProxy is a lightweight proxy that exposes the channels and electronic program guide (EPG) data of a running TVHeadend instance through a minimal HDHomeRun-compatible HTTP interface. It lets clients that expect a direct HTTP stream endpoint, such as Plex DVR and HDHomeRun apps, discover and stream live channels without talking to TVHeadend directly.

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.

41/100 Fair

Maintained
70last commit 49 days ago
Popular
00 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
0
Open issues
0
Last commit
2026-10-02
Activity
stale

Checked yesterday - source: GitHub (maschhoff/TVHProxy)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is not supported.

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

First-install notes

  • Container configuration tvhProxy is a Python service built for container deployment. Before starting the container, set its environment variables to point at your running TVHeadend instance so it can proxy channels and EPG. source

Fetched yesterday - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How is TVHProxy configured?

Configuration is read from environment variables only. It no longer uses a .env file or python-dotenv, so container environment variables should be set.

Which setting controls the public base URL returned to clients?

Set TVH_PROXY_URL to the full public base URL clients should use. If set, that exact URL is used for BaseURL and LineupURL.

How does TVHProxy serve EPG data before the first update finishes?

The /epg.xml endpoint serves a cached TVH_CACHE_FILE immediately. On startup it triggers a non-blocking fetch, and a background fetch runs daily at TVH_EPG_UPDATE_TIME, default 00:00. If no cache exists yet, it returns HTTP 503 while the initial fetch runs.

What port does the TVHProxy web service listen on by default?

It listens on the configured port. The default port is 5004.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads