TVHProxy
TVHProxy is a lightweight proxy that exposes the channels and electronic program guide (EPG) data of a running TVHeadend instance through a minimal…
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
Variants
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
- tvhProxy broke Plex (and TVHE, for good measure) : r/PleX - Reddit (reddit)
- TVHeadEnd + tvhProxy + FabIPTV + Plex : r/PleX - Reddit (reddit)
- tvhProxy + tvHeadend + Plex... Help : r/PleX - Reddit (reddit)
- Does anyone have Antennas or tvhProxy and Plex DVR working ... - Reddit (reddit)
- Live TV through IPTV Service using tvhProxy and TVheadEnd - Reddit (reddit)
Collected 49 days ago - public community threads