Add an M3U playlist on iPhone

Before you start: what an M3U URL looks like

Flipbox includes no channels and no playlists. You bring your own, from a provider you already pay. When you subscribed, your provider sent a welcome message — usually email or chat — containing either an M3U link or an Xtream Codes login. If you were given a server address with a separate username and password rather than one long link, use the Xtream Codes guide instead; it is the better connection type when you have the choice (here is why).

An M3U URL is one long address, typically shaped like this:

http://line.example.net:8080/get.php?username=YOUR_USER
    &password=YOUR_PASS&type=m3u_plus&output=m3u8

Three things in it matter for troubleshooting later: the port (the number after the colon, often 8080 or 80), the type (m3u_plus carries channel logos and guide IDs; plain m3u does not), and the output (choose m3u8 — HLS, Flipbox's native engine; use ts only if your provider's HLS misbehaves, and note raw .ts streams aren’t guaranteed to play in the launch version). Copy the link exactly as sent; a single swapped character in the username or password is the single most common reason a playlist refuses to load.

Adding the playlist in Flipbox

1. Open Flipbox and choose Add playlist

   On a fresh install, Flipbox opens straight into setup. On the Add playlist screen, choose M3U URL as the source type. (If you would rather kick the tyres first, the built-in demo playlist loads a handful of freely licensed streams with one tap — no subscription needed.)

2. Paste the URL and name it

   Paste the full M3U link from your provider's message. Give the playlist a name you'll recognise — the provider's name or “Living room line” — so backups and failover stay legible later.

3. Attach the EPG URL, if you have one

   M3U playlists don't carry programme data themselves. If your provider gave you a separate EPG or XMLTV link (it usually ends in .xml or .xml.gz), add it in the same screen and the timeline guide fills itself in. No EPG link in your welcome message? Ask your provider for one — most have it — or test any link you're unsure of with our free EPG checker first.

4. Let Flipbox load and read the list

   Flipbox downloads the playlist and parses it on your phone — nothing is uploaded anywhere. Big lists are normal in this category; a 15,000-line playlist takes a moment on first load, and is exactly what the cleanup pass in the next step exists for.

5. Run the cleanup preview

   Most provider lists carry every channel three times — HD, FHD, and 4K variants side by side. Flipbox's one-tap cleanup collapses the duplicates into single entries; on a real 17,000-channel test list, about 8,600 actual channels remain. You always see the preview with real numbers first; applying it is a Pro feature, and it never touches the provider's copy of the list.

6. Play something

   Tap a channel. If it plays, you're done — the guide, favourites, and the surf overlay are all downstream of this moment. If it doesn't, the next section is for you.

Adding a local playlist file instead

Flipbox also opens playlist files — useful for home setups (a media server that exports M3U), for lists you maintain yourself, or for a provider file you saved from a message. Choose Local file when adding a playlist and pick the .m3u or .m3u8 file from the Files app. Local files behave identically to URLs, except they don't refresh themselves — when your source updates, re-import the file.

When the playlist won't load

“Could not load playlist” or an endless spinner

• Re-copy the link. Messaging apps love to break long URLs across lines or swallow the & characters. Copy it from the original message in one piece, ideally via your provider's portal.
• Check the port. If the URL has no :8080 (or similar) after the server name and your provider's message shows one, the port is missing — paste the exact address.
• Try the other scheme. Some servers answer only on http://, some only on https://. Swap the prefix once before blaming anything else.
• Confirm the line is active. Expired subscriptions and password resets are the boring, frequent cause. Log in to your provider's portal or ask their support whether the line is live — Flipbox can only play what the server will serve.

The playlist loads, but it's empty or half-empty

• Wrong output format. If your provider's portal offers several download formats, choose m3u_plus with m3u8 (HLS) output — Flipbox's native engine. Use ts only if your provider's HLS misbehaves; raw .ts streams aren’t guaranteed to play in the launch version. A JSON or “enigma” export is not an M3U playlist.
• Categories hidden at the source. Some providers let you toggle channel groups in their portal; an “empty” group there is empty in every player.
• One group missing, the rest fine? That's a provider-side change, not a parsing fault — lists get reorganised constantly. Pull-to-refresh picks up the current state.

It loads, but playback stutters

That's a different problem with its own page — work through the buffering guide, which separates network, device, and server causes in the order that actually finds the culprit.

Channels play, but the guide is blank

Guide data is separate plumbing from the playlist itself. The EPG repair guide covers blank guides, wrong times, and stale data — and the EPG checker will tell you in ten seconds whether the XMLTV file your provider gave you is any good.

Questions that come up

Keep going

• Xtream Codes login on iPhone — the cleaner way to connect, if your provider supports it
• Fix a blank or wrong TV guide — EPG mapping, offsets, and stale data
• Fix buffering — find the real cause before changing settings at random
• What is an M3U playlist? — the format, explained without folklore