Home

Awesome

Hypcast

Screenshot of Hypcast tuned to a channel

Hypcast is a web-based multi-party live television streamer based on GStreamer and Pion WebRTC, designed to work with TV tuner hardware on Linux hosts. Start it up, click a channel, and stream live TV from wherever you are. Connect with another device and share a perfectly synchronized live stream, even as you change channels.

Please note…

Setup Guidelines

There are no "official" instructions or support for running Hypcast, but if you're willing to work through it and try it out here are some general guidelines.

Hypcast requires a supported ATSC tuner card, along with a channels.conf file providing tuning information. The w_scan2 utility can generate this file. For example, to scan for over-the-air channels within the United States:

w_scan2 -f a -c us -X > channels.conf

If you're okay with a software-based transcoding pipeline, it's probably easiest to run Hypcast using the container image published at ghcr.io/ahamlinman/hypcast:latest, with the following configuration:

Alternatively, if you want to enable hardware accelerated video processing through VA-API (which the container image does not support), you can install and configure GStreamer and gstreamer-vaapi on your own system, then build and run the Hypcast binary yourself with -video-pipeline vaapi. See the Makefile for details of how to build a Hypcast binary with embedded client assets for convenience.

Hypcast is not designed to be exposed to the Internet! It is expected to run on a fast local network, or perhaps over a private VPN. Allowing public access could present security issues and/or violate laws in your jurisdiction (be advised that I am not a legal professional, that the suggestion of this possibility does not constitute legal advice, and that as a user you are fully responsible for ensuring that your personal usage of Hypcast complies with relevant local laws).

Potential Improvements