Prerequisites: IPTV Account

Telly is designed to work with what we'll call Plain Old IPTV.

By that, we mean something like Iris, Area51, Helix.

Your IPTV provider has to publish DIRECTLY an M3U file that contains the M3U plus fields and plain old http/https links to the streams; ideally links to TS streams. Often you can enable these things with flags on the IPTV URL.

Here's a snippet of an m3u with the m3u plus fields:

#EXTM3U
#EXTINF:-1 tvg-id="aande.ca" tvg-name="VIP CA : A&E HD" tvg-logo="https://foo.org/logo.png" group-title="VIP Canada HD/FHD",VIP CA : A&E HD
http://iptv.net:83/USERNAME/PASSWORD/STREAMID
#EXTINF:-1 tvg-id="" tvg-name="VIP CA : ABC HD" tvg-logo="https://foo.org/logo.png" group-title="VIP Canada HD/FHD",VIP CA : ABC HD
http://iptv.net:83/USERNAME/PASSWORD/STREAMID
#EXTINF:-1 tvg-id="abcspark.ca" tvg-name="VIP CA : ABC SPARK" tvg-logo="https://foo.org/logo.png" group-title="VIP Canada HD/FHD",VIP CA : ABC SPARK
http://iptv.net:83/USERNAME/PASSWORD/STREAMID
#EXTINF:-1 tvg-id="amc.ca" tvg-name="VIP CA : AMC HD" tvg-logo="https://something.org/link/to/logo.png" group-title="VIP Canada HD/FHD",VIP CA : AMC HD
http://iptv.net:83/USERNAME/PASSWORD/STREAMID
...

And the same channels as a plain m3u without those fields:

#EXTM3U
#EXTINF:-1,VIP CA : A&E HD
http://iptv.net:83/USERNAME/PASSWORD/STREAMID
#EXTINF:-1,VIP CA : ABC HD
http://iptv.net:83/USERNAME/PASSWORD/STREAMID
#EXTINF:-1,VIP CA : ABC SPARK
http://iptv.net:83/USERNAME/PASSWORD/STREAMID
#EXTINF:-1,VIP CA : AMC HD
http://iptv.net:83/USERNAME/PASSWORD/STREAMID
...

Published directly

Telly is going to retrieve this M3U file and parse it. It won't follow links until it finds a valid m3u.

Recently we ran into an IPTV provider that returned an M3U containing one "channel"; the one channel's "stream" link was to the full m3u. Telly's not set up to work with such a system. If your provider does this, you'll probably have to retrieve the full M3U file yourself and pass the file to telly.

M3U_Plus fields

tvg-id
tvg-name
tvg-logo
group-title

telly uses these for filtering and EPG matching, depending on the version.

HTTP links

By default, telly works by simply redirecting Plex to the stream URL when it asks to tune a channel. These links should be plain http/https links for this to work well.

TS Streams

Plex is not compatible with m3u8 streams. Telly's FFMpeg support will transcode those streams into something that Plex accepts, but that will require some extra configuration.