← All guides

Add an M3U playlist

Use this if your provider gave you a playlist link (often ending in get.php?…&type=m3u_plus or .m3u) or you have a playlist file (.m3u / .m3u8, optionally .gz).

Open the add screen

Phone

  1. Tap the IPTV tab. First time? Tap Add IPTV provider. (Or: profile avatar → Settings → Integrations → IPTV (Xtream Codes) → Add Playlist.)
  2. At the top, set Source Type to URL — or File for a local file.

TV

  1. Go to Settings → Integrations → IPTV (Xtream Codes) → Add IPTV account. Don't use Add IPTV provider on the IPTV tab — see the warning below.
  2. Set Source Type to URL (or File).
The empty IPTV screen on a TV, offering Add IPTV provider or Add from phone
TV — first time in IPTV: Add IPTV provider or Add from phone.

On the TV, Add IPTV provider does not open the add form — it jumps to the root of Settings, on Account. The path that works is Settings → Integrations → IPTV (Xtream Codes) → Add IPTV account. The TV guide walks it screen by screen.

Hate typing with the remote? Choose Add from phone instead — scan the QR with your phone and enter the playlist there. It appears on the TV automatically.

Option A — playlist URL

  • M3U URL — paste the full link from your provider, e.g. http://host:port/get.php?username=…&password=…&type=m3u_plus or …/playlist.m3u.
  • User-Agent (optional) — leave empty unless your provider requires a specific player string (e.g. VLC/3.0.20 LibVLC/3.0.20).
  • Name (optional) — anything you like, e.g. “Living room”.
  • Press Add Playlist. Tuvora downloads and indexes the whole list once so browsing is fast — large playlists can take a moment.
The M3U playlist form on a phone, with Source Type set to URL
Phone — Source Type URL: the M3U Playlist form (with optional XMLTV EPG override below).

Option B — playlist file

  • Set Source Type to File and tap Choose file; pick your .m3u / .m3u8 (or .gz) file.
  • Optionally name it, then Add Playlist.
  • The file is copied into the app — you can move or delete the original afterwards.
  • File contents don't sync between devices (URLs do). On a TV with no file picker you'll see: “No file picker on this device — add the file by URL or from your phone (it syncs).”

Troubleshooting

  • Empty after adding? Big lists index in the background — give it a minute, then reopen IPTV.
  • Error on save? Test the same URL in VLC. If it fails there too, the link or your subscription is the problem — contact your provider.
  • Works in VLC but not Tuvora? Some providers lock playback to a player string — set User-Agent to the one they expect and save again.
  • Guide/EPG missing? Many M3U links pair with a separate EPG URL from your provider — check the playlist's settings after adding.

Your playlist URL usually contains your username and password. Never post it publicly — blur or replace it with http://REDACTED:8080/… in screenshots and bug reports.

Still stuck? Open a report on GitHub — never include your server URL, username or password.