Lumastra for Live TV

A self-hosted IPTV server with an EPG

Lumastra is a self-hosted IPTV server for watching Live TV in its web app, the Apple apps and Jellyfin apps. Import an M3U playlist, Xtream Codes account or HDHomeRun tuner, match channels to an XMLTV EPG, and keep backup feeds. For watching, not recording.

Use sources you're licensed to receive: your own tuner, broadcaster streams, or feeds an authorised provider licenses for third-party players.

What it does with your source

Lumastra reads the source itself: no separate Threadfin or xTeVe, because Lumastra includes its own stream proxy. For M3U and Xtream playlists, Plex needs such a proxy in front; Jellyfin takes M3U and HDHomeRun directly but has no backup feeds.

Matches the EPG (XMLTV)

The guide is XMLTV: a URL you add for M3U, the provider's own guide for Xtream, SiliconDust's guide for HDHomeRun.

Backup feeds

If a feed fails, the proxy moves to the next one.

One upstream connection per channel

All viewers of a channel share it. It's a transport counter; it doesn't change what your provider allows.

Simple mode with PIN

Large type and numbered channels for older viewers.

HDHomeRun support is implemented but has not been tested on real tuners.

The Live TV programme guide (EPG) of the demo: fictional channels in rows by category, a timeline from 19:00 to 23:00 with a now marker, and fictional programmes
The guide grid with now and next. Fictional channels and programmes.
The programme detail panel for the fictional programme
The detail panel of a programme. Fictional.

Using Lumastra as a Threadfin alternative

Threadfin and xTeVe sit between your playlist and a media server such as Plex or Jellyfin, and have no player of their own. Lumastra does both jobs: it reads the source, maps the guide and plays the channels in its own apps and in Jellyfin apps.

  1. Add a source: an M3U playlist with its XMLTV guide URL, an Xtream Codes account or an HDHomeRun tuner.
  2. Lumastra imports the channels, groups backup feeds of one station and sorts channels into categories.
  3. Pick countries and groups under Configure Lineup. Lumastra matches the channels to the guide.
  4. Add viewers to the Live TV group. They watch in the web app, the Apple apps or a Jellyfin app.

Add a source

Good to know

Turn it on with FEATURE_LIVETV, run the stream proxy (STREAM_PROXY_URL, STREAM_PROXY_SECRET), and add viewers to the Live TV group. LAN sources like HDHomeRun need LIVETV_ALLOW_PRIVATE_URLS=true. Live TV guide