← All projects
Web App

TunerWeb

Watch HDHomeRun live TV in any web browser — no apps required.

Year
2023
Our role
Design & engineering
Stack
GoFFmpegReactTypeScriptHLS.js

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 + TypeScript
  • Responsive design
  • HLS.js — Adaptive streaming

Perfect For

Cord Cutters

Keep cable for sports and 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

Have a project like this one?

We'd be glad to talk through your goals, your constraints, and whether we're the right team for the work.