If you’re an HDHomeRun user who relied on the official Signal Android app for antenna alignment and signal monitoring, you’ve probably noticed it’s been discontinued. After getting frustrated with the lack of a good replacement, I decided to build my own modern web-based solution that not only recreates the original functionality but actually improves on it.
What is HDHomeRun Signal Web?
HDHomeRun Signal Web is a containerized web application that provides real-time signal monitoring, channel tuning, and device management for HDHomeRun devices. It runs on any platform with Docker and automatically discovers your HDHomeRun devices on the network.
Why Build This?
The original Android app was invaluable for antenna alignment and signal troubleshooting. When it disappeared, there wasn’t a good cross-platform alternative that provided the same level of detail and real-time monitoring. I wanted something that:
- Works on any device with a web browser
- Can run 24/7 on low-power hardware
- Provides real-time signal metrics
- Supports modern features like ATSC 3.0
Key Features
Device Management
The app automatically discovers HDHomeRun devices on your network and lets you switch between devices and tuners through an intuitive interface. No manual IP configuration needed.
Real-Time Signal Monitoring
Get live updates of:
- Signal Strength in dBm (raw power level)
- SNR Quality in dB (signal-to-noise ratio)
- Symbol Quality (error correction quality)
These metrics update in real-time as you adjust your antenna or scan channels.
Antenna Tuning Mode (New!)
This is where the app really shines. The antenna tuning mode lets you monitor all tuners simultaneously with real-time graphs showing signal strength and SNR quality over the last 60 seconds. Each tuner displays a color-coded badge:
- Green (100%): Perfect signal lock – your antenna is properly aligned
- Red (<100%): Signal present but needs improvement
- Gray (0%): No signal detected
This makes antenna alignment much faster and more precise than the old app ever was.
ATSC 3.0 Support
For NextGen TV broadcasts, the app displays PLP (Physical Layer Pipe) and L1 signaling information, giving you deeper insight into modern broadcast signals.
Progressive Web App
Install it on your mobile device for a native app-like experience. It works offline once installed and provides the convenience of the original Android app.
Perfect for Raspberry Pi
While this runs anywhere Docker is supported, a Raspberry Pi is the ideal platform:
- Low power consumption for 24/7 operation
- Small form factor to place near your antenna
- More than enough power for signal monitoring
- Cost-effective dedicated hardware
The Docker image supports both AMD64 and ARM64 architectures with prebuilt images on Docker Hub, so deployment is instant on any platform.
Getting Started
Deployment couldn’t be simpler. Just create a docker-compose.yml file with this content:
yaml
version: '3.8'
services:
hdhomerun-signal:
image: petelombardo/hdhomerun-signal-web
network_mode: host
restart: unless-stopped
environment:
- NODE_ENV=production
- PORT=3000
volumes:
- /etc/localtime:/etc/localtime:ro
Then run:
bash
docker-compose up -d
That’s it! Access the web interface at http://your-server-ip:3000 and the app will automatically discover your HDHomeRun devices.
No cloning, no building, no configuration files. The prebuilt images on Docker Hub handle everything.
Technical Stack
- Frontend: React with Material-UI for a clean, modern interface
- Backend: Node.js with Express
- Real-time Communication: WebSockets via Socket.io
- HDHomeRun Integration: Uses the official
hdhomerun_configcommand-line tool - Deployment: Multi-arch Docker images (AMD64/ARM64) on Docker Hub
Use Cases
Antenna Alignment
The simultaneous multi-tuner monitoring mode makes antenna alignment significantly easier. You can watch signal quality across all tuners in real-time as you adjust your antenna position.
Signal Troubleshooting
Quickly identify weak channels or reception issues by tuning through channels and monitoring the signal metrics.
Multi-Device Monitoring
If you have multiple HDHomeRun devices, you can easily switch between them to check signal quality across your setup.
What’s Next?
I’m continuing to improve the app based on real-world usage. Some ideas in the pipeline:
- Channel scanning and favorite lists
- Historical signal logging
- Mobile-optimized tuning controls
- Email/push notifications for signal issues
Try It Out
The project is available on:
- Docker Hub:
petelombardo/hdhomerun-signal-web(pull and run!) - GitHub: github.com/Petelombardo/hdhomerunsignal (source code)
If you’re an HDHomeRun user who misses the Signal app or just wants better tools for antenna optimization, give it a try. The entire deployment takes less than a minute!
Feedback and contributions are always welcome.





