vk496/jellyfin-htsp-tuner — explained in plain English
Analysis updated 2026-05-18
Add live TV channels from a Tvheadend server into a Jellyfin media server
Get automatic program guide setup without manually mapping channels
Watch live TV with correct video quality, HDR, and audio language handling
Share a single TV stream connection across multiple viewers watching the same channel
| vk496/jellyfin-htsp-tuner | allquixotic/conanpatcher | i-stream/crossef | |
|---|---|---|---|
| Stars | 4 | 5 | 5 |
| Language | C# | C# | C# |
| Last pushed | — | 2022-12-08 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | moderate | moderate | easy |
| Complexity | 3/5 | 3/5 | 2/5 |
| Audience | developer | ops devops | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires an existing Jellyfin server and a running Tvheadend server to connect to.
This project is a plugin for Jellyfin, the open-source media server, that lets it pull in live TV channels from a separate program called Tvheadend, which handles TV tuner hardware and channel data. Jellyfin already has an official plugin for Tvheadend, but that older plugin only uses Tvheadend's richer connection method, called HTSP, to fetch channel names and program guide information. For the actual video, it falls back to a simpler and less capable method. This new plugin instead uses that richer connection for the video itself, so the stream is pulled directly and reassembled inside Jellyfin rather than fetched a plainer way. To use it, you add it the same way you would add any live TV tuner in Jellyfin, and you can add more than one if you have multiple Tvheadend servers. Once you add a working connection, Jellyfin automatically sets up the matching program guide, so you do not have to manually match channels to guide listings. Beyond basic streaming, the plugin tries to get technical details right automatically, things like video quality, color information, and audio languages, so that Jellyfin makes good decisions about whether to play a stream directly or convert it first. It supports multiple audio tracks and marks audio description tracks for accessibility. Subtitles that are transmitted as images are carried through and shown, though an older style of subtitle called teletext is deliberately left out because Jellyfin cannot currently display it without breaking playback. Each channel keeps a limited amount of video buffered in memory rather than saving to disk, so a viewer who is briefly behind does not stall or fill up storage. If several people are watching the same channel, they share a single connection instead of each opening a new one. The plugin also tries to fill in artwork for TV shows that do not have any pictures available, by grabbing an occasional still image from the live video itself and stamping the channel's logo on it, done carefully to avoid interfering with anyone actively watching. It also cleans up leftover artwork files for old programs that Jellyfin itself forgets to delete. Recording still happens through Jellyfin's own recording feature, working the same way it would with any other tuner.
A Jellyfin plugin that pulls live TV directly from Tvheadend using its full streaming connection, instead of the simpler fallback method the official plugin uses.
Mainly C#. The stack also includes C#, Jellyfin, Tvheadend.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.