HD Homey

A Proxy App for HD Homerun devices. Making it easier to connect and share live tv over the internet!

• HD Homey
  • Features
  • Install
    • Docker
    • Docker Compose
    • Source
  • Configuration
  • Usage
    • Watch
    • Lineup

Features

• Serve the lineup.json file, altering it to work over the internet via HD Homey's proxy
• Show a list of channels with a link to the stream
• Proxy the video stream from the HD Homey to the user
• More features (or bugs) when I get to them...

Install

HD Homey is deployable via docker or source, with the only need being the URL/IP address of your HDHR box.

Docker

To install using the latest docker image, replacing {TUNER_IP} with the ip address of your tuner:

docker run -d \
    --name=hd_homey \
    -v ./data/db:/data/db \
    -p 3000:3000 \
    -e HD_HOMEY_TUNER_PATH={TUNER_IP} \
ghcr.io/shaunburdick/hd-homey:latest

This will store the HD Homey database locally in ./data/db

See Configuration for any additional environment variables you would like to set

Docker Compose

To install using docker compose:

1. Copy the contents of compose.yml to a compose.yml file in your local path
2. Update the compose.yml file, adding Environment variables as needed for configuration
3. Deploy the application: docker compose up -d

This will store the HD Homey database in a docker volume

Source

To install using the source:

1. Install Node v20+
2. Download the source code:
   1. Git: git clone https://github.com/shaunburdick/hd-homey.git
   2. Zip: Download ZIP
3. Install dependencies: npm ci
4. Copy and fill out your environment file: cp .env-example .env
5. Run the dev server: npm run dev

Configuration

The following values are available for configuration as environment variables:

• HD_HOMEY_TUNER_PATH: The URL path to your turn, example: http://192.168.1.50
• HD_HOMEY_PROXY_HOST: The URL to use when rewriting values proxied from your tuner. Example https://tuner.myawesomesite.com
  This can be empty and the app will attempt to infer the URL by inspecting the request, but if you are having trouble (or proxy this app in docker) then you can provide a hint.
• HD_HOMEY_DB_PATH: The path to the local database for configuration values (not used yet), example: ./data/db

Usage

Then open your favorite browser to http://localhost:3000 (assuming you used to configs above)

Watch

Watch provides a list of channels available. Clicking on the channel will give you instructions on how to watch the stream.

Lineup

Lineup provides a transformed JSON line. This could be used by other viewing apps like Channels or Jellyfin to generate channels for viewing. (Maybe, I haven't tested this yet)