Skip to content
bkbillyPublic

About

Modern DVB TV streaming server and DVR with instant WebRTC zapping, zero idle CPU, and native Plex & Jellyfin support

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

DVB-Web Logo

DVB-Web

license OS - Linux Go GHCR Live Demo

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).


✨ Features

  • ⚡ 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.

🚀 Quick Start

Docker Compose (Recommended)

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=UTC
docker compose up -d

Open http://localhost:8080 in your browser.


Docker CLI

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

Build from Source

# Prerequisites: Linux, Go 1.24+, ffmpeg
go build -o dvb-web cmd/server/main.go
./dvb-web

No physical tuner attached? Run ./dvb-web -mock to test with simulated channels and sample EPG data.


⚙️ CLI Arguments

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

📺 External Player Integration

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>:8080 directly in Safari or point any media player to the HLS URL for native hardware decoding and AirPlay.

📄 License & Credits

About

Modern DVB TV streaming server and DVR with instant WebRTC zapping, zero idle CPU, and native Plex & Jellyfin support

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages