Your channels. Your recordings. Your server.
A self-hosted live TV and DVR server for HDHomeRun, IPTV, and HLS sources. Browse a unified guide, watch from any modern browser, and keep recordings on storage you control.
Get started · Configuration · Contributing
SignalHaven brings live television, guide data, scheduling, and playback together in one responsive web app—without sending your viewing history or recordings to a hosted service.
- Watch live TV with an in-player mini guide and channel switching.
- Pause and rewind live streams with a configurable rolling time-shift buffer.
- Record once or automatically with one-off schedules, series rules, retention controls, and conflict visibility.
- Browse one unified guide backed by HDHomeRun guide data or XMLTV sources.
- Manage your lineup by searching, sorting, favoriting, hiding, and reordering channels.
- Play recordings in the browser with resume progress, captions, and optional Comskip commercial markers.
- Adapt playback to your hardware with direct streaming, quality profiles, and optional VideoToolbox, VA-API, Quick Sync, or NVENC acceleration.
- Use it anywhere on your network through a responsive light- and dark-mode interface.
The recommended installation uses Docker Compose and includes PostgreSQL, FFmpeg, automatic database migrations, health checks, and persistent volumes.
- Docker Engine with Docker Compose
- A supported TV source: HDHomeRun, an M3U/M3U8 playlist, or a direct HLS stream
- Guide data from a supported HDHomeRun subscription or an XMLTV URL/file if you want program listings
- Enough local storage for your recordings and live TV buffer
git clone https://github.com/rrainn/SignalHaven.git
cd SignalHaven
cp .env.example .envOpen .env and replace the default POSTGRES_PASSWORD with a strong, unique password. Then start SignalHaven:
docker compose up -dOpen http://localhost:3000. The first-run wizard will help you add a tuner, connect guide data, choose a recordings folder, and review channel mapping.
Your database and recordings persist in Docker volumes. To use an existing PostgreSQL server or change storage and playback behavior, see the configuration reference.
Important
SignalHaven is designed for a trusted home network. If you make it reachable from the internet, place it behind an HTTPS reverse proxy with authentication and appropriate network controls.
Review the release notes, then pull and restart the stack:
docker compose pull
docker compose up -dFor reproducible deployments, set SIGNALHAVEN_IMAGE in .env to a numbered release instead of latest.
| Source | What SignalHaven supports | Guide data |
|---|---|---|
| HDHomeRun | Network discovery, channel import, live TV, and tuner-aware recording | Configured automatically; SiliconDust's guide feed requires an HDHomeRun DVR guide subscription |
| IPTV / M3U | Remote M3U or M3U8 playlists, channel metadata, and live TV | Optional XMLTV URL; channels are matched using playlist metadata such as tvg-id |
| Generic HLS | A direct M3U8 stream represented as one virtual channel | Add a separate XMLTV source if guide data is available |
SignalHaven can also use additional remote or local XMLTV sources when your tuner does not provide guide data.
| Resource | Use it for |
|---|---|
| Configuration | Environment variables, storage, transcoding, time shifting, lineup sync, UI preferences, and observability |
| Architecture | Services, runtime flow, recording lifecycle, and repository design |
| Design and brand guide | Product voice, visual system, and brand assets |
| Contributing guide | Local development, validation commands, and pull request expectations |
| OpenAPI specification | API reference from a running SignalHaven server |
Contributions are welcome. SignalHaven is a pnpm monorepo with a Next.js frontend, an Express API, PostgreSQL through Drizzle ORM, and shared Zod schemas.
To start a development environment:
pnpm install --frozen-lockfile
cp .env.example .env
docker compose up -d postgres
pnpm run devBefore opening a pull request, run the project validation suite:
pnpm run format:check
pnpm run lint
pnpm run typecheck
pnpm test
pnpm run buildRead CONTRIBUTING.md for prerequisites, repository layout, resource-bounded preview commands, and contribution expectations. If you have found a bug or want to propose a feature, open an issue.
I used AI extensively to build this application. While I understand that some people may have concerns about AI-generated code, I believe it is a tool that when used effectively can help developers create better software than they could on their own. This application would still be sitting on my todo list if it wasn't for AI. I have personally reviewed all of the code, and I am confident it meets my standards. However, like humans, AI can make mistakes, so please report any issues you find.
SignalHaven and rrainn LLC do not endorse piracy or any other illegal use of the software. SignalHaven is free, open-source software, and we do not monitor or control how users choose to operate it; users are solely responsible for complying with applicable laws and respecting copyright.
Copyright 2026 rrainn LLC
SignalHaven is not affiliated with SiliconDust, the makers of HDHomeRun.