Features
HD Homey provides a complete solution for remotely accessing your HDHomeRun live TV streams with security, transcoding, and multi-user support.
Core Features
📺 Tuner Management
Add, configure, and manage multiple HDHomeRun devices with automatic channel discovery and connection validation.
Key capabilities:
- Auto-discovery of HDHomeRun devices on your network
- Connection testing and validation
- Multiple tuner support
- Manual tuner configuration
🎬 Channel Streaming
Browse and stream live TV channels through your web browser or external media players.
Key capabilities:
- Channel lineup browsing
- Direct streaming in browser (native MPEG-2)
- HLS transcoded streams for compatibility
- External player support (VLC, mpv, etc.)
⭐ Channel Favorites
Personalize your viewing experience by organizing channels with favorites and hiding unwanted content.
Key capabilities:
- Mark frequently watched channels as favorites
- Hide unwanted channels from view
- Auto-organized into Favorites/Channels/Hidden sections
- Per-user preferences with instant updates
🔄 Video Transcoding
Real-time conversion of MPEG-2 streams to H.264/HLS for broader device compatibility and bandwidth optimization.
Key capabilities:
- Automatic MPEG-2 to H.264 conversion
- HLS stream generation
- Shared session management (multiple viewers, one transcode)
- Configurable quality settings
👥 User Management
Role-based access control with admin and viewer roles for secure multi-user access.
Key capabilities:
- Admin and viewer role system
- User account creation and management
- Password change functionality
- Session management
🔗 User Invitations
Generate secure invitation links for easy user onboarding without sharing credentials.
Key capabilities:
- Single-use invitation links
- Role assignment (admin/viewer)
- Expiration management
- Invitation tracking
🔐 Stream Security
Token-based authentication ensures only authorized users can access your streams.
Key capabilities:
- HMAC-SHA256 stream tokens
- Time-limited access tokens
- Device fingerprinting
- Secure token validation
Feature Highlights
Web-Based Interface
Modern, responsive web interface built with React and Next.js:
- Clean, intuitive design using new.css
- Mobile-responsive layouts
- Accessibility compliance (WCAG 2.2 AA)
- Dark theme support
Authentication & Security
Secure authentication powered by Better-Auth:
- Scrypt password hashing
- JWT session tokens
- Cookie-based sessions with HttpOnly flags
- CSRF protection
Database & Storage
Lightweight SQLite database with Drizzle ORM:
- Automatic migrations
- Simple backup and restore
- No external database dependencies
- Efficient query performance
Docker Support
First-class Docker support for easy deployment:
- Pre-built images on GitHub Container Registry
- Docker Compose configuration
- Volume persistence
- Health checks
Build Identification
Comprehensive version tracking and build metadata for debugging and monitoring:
- Version Display: Shows semantic version with commit SHA (e.g.,
1.0.0-beta.5 (a1b2c3d)) - Context-Aware Formatting:
- Production:
VERSION (COMMIT) - Development feature branch:
VERSION (BRANCH@COMMIT) - Development with uncommitted changes:
VERSION (BRANCH@COMMIT-dirty)
- Production:
- UI Locations: About page, footer (responsive layout), and startup log
- API Access:
/api/healthendpoint includes complete version metadata - Build Metadata: Includes version, commit SHA, branch name, build date, and environment
Feature Status
All core features are complete and tested:
| Feature | Status | Test Coverage |
|---|---|---|
| Tuner Management | ✅ Complete | ✅ 100% |
| Channel Streaming | ✅ Complete | ✅ 100% |
| Channel Favorites | ✅ Complete | ✅ 100% |
| Video Transcoding | ✅ Complete | ✅ 100% |
| User Management | ✅ Complete | ✅ 100% |
| User Invitations | ✅ Complete | ✅ 100% |
| Stream Security | ✅ Complete | ✅ 100% |
| Authentication | ✅ Complete | ✅ 100% |
Current Version: v1.0.0-beta.5
Coming Soon
Future features under consideration:
- EPG (Electronic Program Guide) integration
- Recording/DVR functionality
- Multi-language support
- Mobile apps (iOS/Android)
Performance Characteristics
HD Homey is designed for efficiency:
- Low resource usage: ~50-100MB RAM for base application
- Scalable transcoding: Shares sessions across multiple viewers
- Efficient streaming: Direct passthrough when transcoding not needed
- Quick startup: Typically under 5 seconds to fully operational
Browser Compatibility
HD Homey works with all modern browsers:
- Chrome/Edge 90+
- Firefox 88+
- Safari 14+
- Mobile browsers (iOS Safari, Chrome Mobile)
Native MPEG-2 playback requires browser codec support or transcoding.