$ guides · 6 min read
IPTV playlist formats explained: M3U, M3U8, XMLTV and server login
M3U, M3U8, XMLTV, server sign-in: what each one is, with examples, so you know which option to choose when you add a source.
M3U: the playlist
An M3U file starts with #EXTM3U and then lists entries of two lines each: a description and an address.
#EXTM3U url-tvg="https://example.com/guide.xml.gz"
#EXTINF:-1 tvg-id="alpha.example" tvg-logo="https://example.com/alpha.png" group-title="General",Alpha TV
https://example.com/live/alpha.m3u8
#EXTINF:-1– a stream with no fixed length (live). Movies may have a duration in seconds.tvg-id– the id used to find the channel in the TV guide.tvg-logo– the channel logo.group-title– the category the channel is listed under.- The text after the comma is the name you see.
Some lists also add per-channel options such as a User-Agent or Referer the server expects; Varpa sends them when they are there.
M3U8 and HLS
.m3u8 is the same format saved as UTF-8, so names in any alphabet display correctly. The extension is also used by HLS (HTTP Live Streaming): in that case the file is not a channel list but the stream itself, split into short segments. Varpa handles both, plus DASH streams and plain video files such as MP4 and MKV.
XMLTV: the TV guide
The guide is a separate XML file with <channel> and <programme> elements, usually compressed as .xml.gz. The playlist points to it with url-tvg (or x-tvg-url), and channels are matched through tvg-id. Full details in how to add a TV guide.
Server sign-in (address, username, password)
Many providers offer access through a web API instead of a single file: you enter the server address, username and password, and the app asks the server for channels, movies, series and the guide separately. Compared with a single file:
- Movies and series arrive with posters, plots, seasons and episodes.
- The guide is found automatically.
- Lists stay up to date without re-importing a big file.
In Varpa the password is stored encrypted on the phone, and stream addresses are built only when you press play, so credentials are not left in plain text in the app's database.
Which one should you use?
| You have… | Choose in Varpa |
|---|---|
A link ending in .m3u / .m3u8 or containing type=m3u | M3U URL |
| A file saved on the phone | M3U file |
| Server address + username + password | Server sign-in |
If your provider offers both a link and a server sign-in, the sign-in usually gives a richer catalogue for movies and series. Next step: open your playlist.