stephenhoos / hdhomerun-jellyfin-guide

What is hdhomerun-jellyfin-guide?

This is a server-side Jellyfin plugin written in C# that keeps Live TV guide data fresh for SiliconDust HDHomeRun tuners. It downloads the official SiliconDust XMLTV feed, converts it into Jellyfin-compatible files, and automatically wires everything up in Jellyfin's Live TV configuration. The plugin handles the full workflow: fetching fresh authentication tokens from your tuner, pulling guide data, writing XMLTV and M3U files, clearing stale cache entries, and triggering Jellyfin's guide import. It supports both the free 2-day guide window and the paid 14-day DVR subscription option.

Why is it gaining traction?

Jellyfin's native HDHomeRun guide integration can be unreliable depending on tuner firmware and cache state. This plugin solves that by hitting SiliconDust's official XMLTV endpoint directly, which HDHomeRun themselves requested after deprecating the old guide API. The "Add My Tuners" button is the real hook: it uses Jellyfin's built-in discovery to find your HDHomeRun and configures Live TV automatically with zero manual setup. The plugin also randomizes refresh intervals to avoid hammering SiliconDust's servers at fixed times, which shows thoughtful engineering around their documented guidelines.

Who should use this?

Jellyfin users with HDHomeRun hardware who want reliable guide data without babysitting their Live TV setup. If you've tried Jellyfin's native HDHomeRun integration and found guide data missing, stale, or inconsistent, this plugin is for you. It's especially useful if you have a HDHomeRun DVR subscription and want the extended 14-day guide window. Home theater enthusiasts running Jellyfin on Docker or a dedicated server will get the most value, though the plugin works on any Jellyfin installation that supports .NET 9.0 plugins.

Verdict

This is a well-architected solution to a real pain point, but at 19 stars and version 0.3.2.0, it's still early-stage software with a credibility score of 0.9%. The documentation is solid and the code shows good practices, but test coverage and community backing are limited. If you need reliable HDHomeRun guide data in Jellyfin today, install it and monitor the diagnostic logs. Just keep an eye on Jellyfin plugin releases for updates as the project matures.