TunerWeb Logo

TunerWeb

Watch HDHomeRun live TV in any web browser - no apps required

Self-HostedOpen SourceHome Network

About TunerWeb

TunerWeb bridges the gap between your HDHomeRun tuner and any web browser. Instead of installing proprietary apps on every device, simply bookmark TunerWeb and watch live TV from your phone, tablet, or computer - anywhere on your home network.

Perfect for cord-cutters who kept their cable subscription but ditched the expensive cable boxes. TunerWeb transcodes your HDHomeRun's MPEG-2 streams on-the-fly to browser-compatible HLS format, with adaptive quality selection for any connection speed.

TunerWeb Screenshot

Key Features

๐ŸŒ Browser-Based Streaming

No apps to install - works in Safari, Chrome, and any modern browser on iOS, Android, and desktop.

๐Ÿ“Š Adaptive Quality

Choose from multiple quality levels (200 Kbps to 4 Mbps) based on your connection - preferences are saved automatically.

โšก On-Demand Transcoding

Streams start only when you watch and stop automatically when idle - saving CPU and power on your server.

๐Ÿ”„ Smart Tuner Management

Tracks concurrent viewers and shares streams when multiple devices watch the same channel (HDHomeRun has 4 tuners max).

๐Ÿ“ฑ Mobile-First Design

YouTube-style responsive interface that works great on phones and tablets - perfect for watching in bed or the kitchen.

๐Ÿณ Docker Ready

Deploy easily with Docker Compose - includes FFmpeg and all dependencies in a single container.

How It Works

  1. 1TunerWeb connects to your HDHomeRun device and fetches the channel lineup
  2. 2When you select a channel, it starts transcoding from MPEG-2 to HLS (H.264)
  3. 3Your browser receives the stream via HLS - the same format Netflix and YouTube use
  4. 4When you stop watching, transcoding automatically stops after 60 seconds

Technical Stack

Backend

  • โ€ข Go 1.25 - Fast, efficient server
  • โ€ข FFmpeg - Industry-standard transcoding
  • โ€ข HLS output - Universal browser support

Frontend

  • โ€ข React 19 + TypeScript
  • โ€ข Tailwind CSS - Responsive design
  • โ€ข HLS.js - Adaptive streaming

Perfect For

๐Ÿ 

Cord Cutters

Keep cable for sports/news without renting boxes

๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ

Multi-Device Homes

Watch on any device without per-device apps

๐Ÿ› ๏ธ

DIY Enthusiasts

Self-hosted, open source, fully customizable

Requirements

  • โ€ข HDHomeRun device (HDHR3, HDHR4, HDHR5, or Flex)
  • โ€ข Linux server or Docker host on your home network
  • โ€ข Cable TV subscription (for encrypted channels)
  • โ€ข ~2GB RAM for transcoding

Open Source & Self-Hosted

TunerWeb is designed for home network deployment. Your TV streams never leave your network - you maintain full control of your data.

Built with Go, React, and FFmpeg

ยฉ 2025 Careful Dream. All rights reserved.