TunelineTuneline
All posts
Tutorials·6 min

By Shamir

How to Add an M3U Playlist on Any Device

Adding an M3U playlist should be the simplest thing your player does. In practice, half the IPTV players make you dig through three settings panels, paste a URL into a modal labeled "Source URI," and pray it parses.

This guide walks through the ten-second version, using Tuneline, on every major platform — and explains what to do when the URL doesn't load on the first try.

If you don't have a player yet, grab Tuneline here — there's a free tier that handles one playlist on one device with no signup required up front.

What You Need First

That's the entire prerequisite list. Tuneline ships with the codec support and EPG handling baked in — there is no "install ffmpeg" step on any platform.

On Mac, Windows, or Linux

  1. Open Tuneline.
  2. Click "Add Playlist" in the top bar (or in the empty-state card if you've never added one).
  3. Paste your M3U URL into the URL field. Give it a name you'll recognize — "Provider A," "Sports," whatever.
  4. Click Save.

That's the whole flow. Within a few seconds, channels populate the sidebar, categorized by the groups your provider declared in the M3U (group-title="Sports" etc.). Click a channel and it plays in the embedded player.

If you have an XMLTV EPG URL from the same provider, paste it into the EPG field on the same screen — Tuneline will fetch and parse the guide, and the now-playing strip and full EPG grid populate automatically. (Why your EPG might not load.)

On Android Phone

  1. Install Tuneline from Google Play.
  2. Open the app, tap the menu → "Add Playlist."
  3. Paste your M3U URL. Name it.
  4. Tap Save.

If you signed in with the same Tuneline account you use on desktop, the playlist also syncs back to your Mac/PC/TV automatically (paid tier). No re-pasting.

On Google TV / Android TV

The on-screen keyboard on a TV is the worst data-entry surface ever invented. Tuneline solves this in two ways:

Option A — Sync from another device (recommended).

  1. Add the playlist on your phone or laptop first (steps above).
  2. Install Tuneline on your TV from the Play Store TV listing.
  3. Sign in with the same account. Your playlist is already there, no typing.

Option B — Add directly on the TV.

  1. Install Tuneline on the TV.
  2. From the home screen, D-pad to "Add Playlist."
  3. Use the on-screen keyboard, or — much better — use the Google TV remote app on your phone, which gives you a real keyboard.
  4. Save.

Cross-device sync is the killer feature on TV specifically. If you've ever paste-typed an M3U URL with a D-pad you'll understand why.

When the M3U URL Doesn't Load

Most "URL didn't work" complaints come down to one of four things:

  1. Wrong format. Some providers offer type=m3u_plus, others type=m3u. If m3u_plus returns nothing, try plain m3u in the URL parameter. Tuneline parses both.
  2. Provider rate-limits or device-bind. If you've used the URL on too many devices, the provider blocks new connections. Check with your provider.
  3. Server is down. Try opening the URL in a browser — if you don't get a download prompt or playlist text, the server is offline.
  4. Wrong protocol. Some providers issue HTTPS-only URLs and others HTTP-only. If one fails, swap the scheme and try again.

If none of those help, join the Discord and we can usually triage it from the URL response alone.

What Tuneline Does That Other Players Don't

A quick honest pitch, since you're already here:

  • One account, every device. Add a playlist once, it shows up on Mac, Windows, Linux, Android, and Google TV. (How sync works.)
  • Forgiving M3U parser. If your provider's M3U is malformed (extra blank lines, non-standard tags), Tuneline still loads what it can rather than failing entirely.
  • Native builds, not Electron wrappers. macOS uses Apple Silicon, Linux uses libmpv with VA-API, Windows uses D3D11VA. Hardware decode for HEVC, AV1, H.264 across the board.
  • No bundled provider, no upsell. You bring your own M3U. We're a player.

FAQ

Can I add multiple M3U playlists?

Yes — on the paid tier. Free tier is limited to one playlist per device. Add as many as your provider relationships demand on paid.

Does Tuneline store my playlist URL on a server?

Only if you sign in. With sync enabled, your playlist URL is stored encrypted in our database so it can sync to your other devices. If you don't want any cloud storage, use the app without signing in — everything stays local.

What's the difference between M3U and M3U8?

M3U8 is M3U encoded as UTF-8. Functionally identical for IPTV use. Tuneline handles both transparently.

Can I import an .m3u file from disk instead of a URL?

Yes — on the desktop builds, "Add Playlist" accepts a local file path. On Android/TV, URL is the only practical input.

Ready to add your first playlist? Download Tuneline and you'll be playing your stream in under a minute.

— Shamir