HD HomeyHDHomeRun Proxy for Remote Streaming

Stream live TV from your HDHomeRun devices anywhere with secure authentication and video transcoding

Get Started

View on GitHub

📺

Tuner Management

Add, configure, and manage multiple HDHomeRun devices with automatic channel scanning and connection validation.

🎬

Live Streaming

Stream channels in your browser or external players with secure token-based authentication.

🔄

Video Transcoding

Real-time MPEG-2 to H.264/HLS transcoding with shared session management for efficient streaming.

👥

User Management

Role-based access control with admin and viewer roles. Generate secure invitation links for easy onboarding.

🔐

Secure Authentication

Better-Auth powered authentication with scrypt password hashing and JWT sessions.

⚙️

Easy Configuration

Simple environment variable configuration with Docker Compose support for quick deployment.

Why HD Homey?

HD Homey makes it easy to access your HDHomeRun live TV streams remotely. Whether you're watching on your laptop, tablet, or phone, HD Homey provides:

Secure Remote Access: Stream your local HDHomeRun devices over the internet with authentication
Modern Web Interface: Clean, responsive UI for browsing channels and managing settings
Flexible Playback: Watch in your browser or use external players like VLC
Efficient Transcoding: Optional real-time transcoding for compatibility and bandwidth savings
Multi-User Support: Share access with family and friends using invitation links

Quick Start

Get HD Homey running in 5 minutes with Docker Compose:

bash

# Download configuration files
curl -O https://raw.githubusercontent.com/shaunburdick/hd-homey/main/compose.yml
curl -O https://raw.githubusercontent.com/shaunburdick/hd-homey/main/.env-example

# Configure environment
cp .env-example .env
# Edit .env and set AUTH_SECRET (use: openssl rand -base64 32)

# Start the application
docker compose up -d

Visit http://localhost:3000 and create your admin account!

Read the full Quick Start guide →

Project Status

Current Version: v1.0.0-beta.5

HD Homey is in active development and ready for production use. All core features are complete with comprehensive test coverage and security hardening.

✅ Tuner management with auto-discovery
✅ Channel streaming with HLS support
✅ User authentication and authorization
✅ Video transcoding with FFmpeg
✅ Invitation-based user onboarding
✅ Mobile-responsive design
✅ Accessibility (WCAG 2.2 AA)

View Changelog

Community & Support

Documentation: You're reading it! Explore the navigation above.
GitHub Issues: Report bugs or request features
Contributing: Learn how to contribute

License

HD Homey is open source software released under the GNU Affero General Public License v3.0 only (AGPL-3.0-only).