Lineup is a .NET application that fetches Electronic Program Guide (EPG) data from a network TV tuner device and converts it into XMLTV format — the standard format used by media servers like Jellyfin and Plex for TV guide display.
It includes a web-based dashboard, a terminal UI, live TV streaming with transcoding, and automatic scheduled EPG fetching with smart incremental updates.
Currently this is only supporting the HDHomeRun Tuners like the HDHomeRun FLEX 4K. Hopefully more can be added in the future.
- Automatic EPG fetching — background service with configurable interval and target days; reacts to settings changes in real time
- Incremental fetching — determines a safe start time based on cached data, avoiding redundant API calls
- XMLTV conversion — full-featured output including episode numbering, categories, artwork, original airdates, and new-episode markers
- Live TV streaming — proxy with ffmpeg transcoding to HLS/fMP4 (profiles: mobile, heavy, internet 720/480/360)
- Device diagnostics — connectivity checks across DNS, ping, HTTP API, TCP, and UDP discovery
- Native HDHomeRun protocol — binary protocol implementation for UDP discovery, TCP control, and channel scanning
- XMLTV endpoint —
/api/xmltvfor external media servers to pull the guide file directly - SQLite caching — EPG data stored locally with automatic cleanup of expired entries
| Project | Description |
|---|---|
Lineup.HDHomeRun.Device |
Local device communication — discovery, channel lineup, native binary protocol |
Lineup.HDHomeRun.Api |
Remote API client — fetches EPG data from api.hdhomerun.com |
Lineup.Core |
Core business logic — orchestration, XMLTV conversion, caching (EF Core + SQLite) |
Lineup.Web |
Blazor Server web app — dashboard, EPG guide viewer, settings, live TV |
Lineup.Tui |
Terminal UI — interactive menu using Spectre.Console |
- .NET 10 SDK
- An HDHomeRun device on your local network
- ffmpeg (required for live TV transcoding; included in the Docker image)
cd src/Lineup.Web
dotnet runThe app starts on http://localhost:8080 by default. Configure the HDHomeRun device address through the settings UI or via the Lineup__DeviceAddress environment variable.
cd src/Lineup.Tui
dotnet runConfigure via environment variables:
Lineup__DeviceAddress— HDHomeRun device IP or hostnameLineup__DatabasePath— path to the SQLite cache database
docker compose up -dOr using the production image:
docker compose -f docker-compose.prod.yml up -dThe Docker image includes ffmpeg for live TV transcoding. Data is persisted via a named volume at /config. Use network_mode: host if your HDHomeRun device requires local network discovery.
All settings are configurable through the web UI's settings page and persisted to settings.json:
| Setting | Description |
|---|---|
| Device Address | HDHomeRun device IP or hostname |
| XMLTV Output Path | Where to write the generated XMLTV file |
| Fetch Interval | Minutes between automatic EPG fetches |
| Target Days | Number of days of EPG data to fetch |
- .NET 10 — target framework for all projects
- Blazor Server — interactive web UI
- Entity Framework Core + SQLite — EPG data caching
- Spectre.Console — terminal UI rendering
- Serilog — structured logging
- ffmpeg — live TV stream transcoding
This project is licensed under the GNU General Public License v3.0.