# TVHProxy

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 is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/6784/tvhproxy

## Description

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.

## Health score

41/100 (Fair), based on 3 of 4 factors.
- Maintained: 70 (last commit 49 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/tvhproxy-0tjydf901w194h?q=tvhproxy
- GitHub: https://github.com/maschhoff/TVHProxy

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

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