A fast, lightweight web TV streaming server and DVR for digital broadcast television (DVB-T/T2, DVB-C, DVB-S/S2). Built in pure Go with WebRTC for instant channel zapping, multi-tuner multiplex sharing, and native integration for Jellyfin, Plex, Kodi, and VLC.
🎮 Live Interactive Demo: Try the frontend directly in your browser without hardware at bkbilly.github.io/dvb-web — featuring simulated broadcast playback, 7-day EPG TV Guide, recordings management, live RF signal analyzer (
S), and teletext (T).
- ⚡ Sub-Second WebRTC Zapping: Instant video rendering (~150ms) on desktop and Android without buffering delay.
- 🍏 Native HLS & Apple AirPlay: In-memory HLS streaming (
/api/stream/hls/<id>/index.m3u8) with automatic device detection for iOS/iPadOS Safari, Picture-in-Picture, and native AirPlay. - 🔍 Ultra-Fast Regional Channel Scanner: Scan preconfigured transmitter sites (UK, Germany, France, Greece, Spain, Italy, Australia) in under 10 seconds, scan specific individual frequencies, or run a full spectrum sweep.
- 💤 Zero-Resource Idle: Automatically releases tuners and stops FFmpeg when idle (0% CPU and low power).
- 🍿 Plex & Jellyfin Integration: Built-in HDHomeRun emulation (UDP discovery on port
65001), M3U playlist (/playlist.m3u), and XMLTV guide (/epg.xml). - 🔀 Smart Multi-Tuner Pooling: Multiplex sharing allows multiple viewers to watch channels on the same frequency using a single tuner.
- 🔴 Integrated DVR with Grace Periods: Schedule future broadcasts from the EPG or record live TV with one click; configurable pre-padding and post-padding ensure full program capture, automatically remuxing to fast-start MP4.
- ⏸️ Live TV Timeshifting: Pause, rewind, and scrub through live broadcast buffers with instant jump-to-live.
- 📡 Real-Time RF Signal Analyzer: Floating HUD diagnostics for RF signal strength, SNR/quality dB, BER, UNC, and carrier/sync/lock flags (press
S). - 📟 Teletext & Subtitles: Retro CRT teletext viewer (press
T) with index, technical specs, and synchronized subtitles (page 888). - 🔴 HbbTV Interactive Portal: Seamless access to interactive TV portals and catch-up services on supported channels (press
H). - 📻 Radio & Multi-Track Audio/Subtitles: Audio-only radio playback with equalizer display, plus live audio language and subtitle switching.
- 🚀 Hardware Acceleration & Resilient Fallback: Automatic detection for Intel/AMD VA-API, NVIDIA NVENC, and Raspberry Pi V4L2 M2M, with automatic runtime CPU encoding fallback (
libx264) if hardware encoders fail. - 📅 Live Multi-Language EPG: Interactive timeline guide with dynamic broadcast EIT table parsing and full program descriptions.
services:
dvb-web:
image: ghcr.io/bkbilly/dvb-web:latest
container_name: dvb-web
restart: unless-stopped
network_mode: host # Recommended for WebRTC, UDP streaming & HDHomeRun discovery
devices:
- /dev/dvb:/dev/dvb # TV Tuners
- /dev/dri:/dev/dri # GPU Hardware Acceleration (Intel/AMD)
volumes:
- ./data:/app/data
environment:
- TZ=UTCdocker compose up -dOpen http://localhost:8080 in your browser.
docker run -d \
--name dvb-web \
--restart unless-stopped \
--network host \
--device /dev/dvb:/dev/dvb \
--device /dev/dri:/dev/dri \
-v $(pwd)/data:/app/data \
ghcr.io/bkbilly/dvb-web:latest# Prerequisites: Linux, Go 1.24+, ffmpeg
go build -o dvb-web cmd/server/main.go
./dvb-webNo physical tuner attached? Run
./dvb-web -mockto test with simulated channels and sample EPG data.
| Flag | Default | Description |
|---|---|---|
-port |
8080 |
HTTP server port for Web UI, WebRTC, and external streaming |
-data-dir |
./data |
Directory storing SQLite database (tv.db), logos, and recordings |
-web-dir |
./web |
Directory for web frontend assets (falls back to embedded static assets) |
-mock |
false |
Enable virtual tuner mode with sample channels and EPG without physical DVB hardware |
| Integration | URL | Compatible Players |
|---|---|---|
| HDHomeRun Tuner | http://<server-ip>:8080 |
Plex Live TV & DVR, Jellyfin HDHomeRun |
| M3U Playlist | http://<server-ip>:8080/playlist.m3u |
Jellyfin, VLC, Kodi, TiviMate |
| XMLTV Guide | http://<server-ip>:8080/epg.xml |
Jellyfin, Plex |
| HLS Stream | http://<server-ip>:8080/api/stream/hls/<id>/index.m3u8 |
Safari / iOS, QuickTime, Apple TV, VLC |
- Plex: Go to Settings → Live TV & DVR → Set up Plex DVR. Enter
http://<server-ip>:8080. - Jellyfin: Go to Dashboard → Live TV → add HDHomeRun (
http://<server-ip>:8080) and XMLTV (http://<server-ip>:8080/epg.xml). - Apple Devices & Safari: Open
http://<server-ip>:8080directly in Safari or point any media player to the HLS URL for native hardware decoding and AirPlay.
- Created and maintained by Vasilis Koulis (bkbilly).
- Developed in collaboration with LLMs.
- Licensed under the MIT License.
