Adding a playlist
A playlist is the connection to your TV provider. OrbitAI.tv understands three kinds, plus a playlist file on a USB drive or a network folder, and an .orbitlist file made with Export.
Start from Add playlist on the welcome screen, or from Settings → Sources → Add playlist. The free version holds one playlist; adding more needs Premium.
Step 1: Playlist type
“Choose the connection details you received from your provider.”
| Choice | Use it when your provider gave you |
|---|---|
| M3U playlist | A playlist link, with an optional TV guide (XMLTV) link. |
| Xtream Codes | A server address with a username and password, or MAC access. |
| Stalker Portal | A portal address and a MAC device identity (MAG). |
| From your phone | Any of the three kinds, typed on your phone instead of with the remote: scan the code with a phone on the same Wi-Fi and send the details to the screen. |
| Import | An .orbitlist file made with Export on another device. See “Import an .orbitlist file” below. |
| Cancel | Closes the wizard. |
On a phone the wizard asks one topic per page (“Step 1 of …”) with Next and Back; on a television all the fields are on one scrolling form.
Step 2: Where is the playlist?
- M3U playlist address (M3U), Server address (Xtream Codes) or Portal address, including its path (Stalker).
- Paste fills the field from the clipboard, handy on a phone.
- For a Stalker / MAG portal, include the full path the provider gave you, for example
https://example.com/stalker_portal/c/. You can point straight to the portal's.phpfile.
An M3U file instead of a link
For an M3U playlist you can choose Import from M3U file instead of typing an address: “pick a .m3u file from a USB drive, a NAS or a shared folder.” A folder browser opens; move with the arrows, open folders with OK or →, go up with ← or Back. When the file is imported you see “… imported · N channels”.
Internal storage is the device's Download folder, but on Android 10 and later it lists only the files OrbitAI.tv saved there itself. A file another app saved there, such as a browser or Downloader, is reached with Another folder from the system…, Android's own file picker, on a device that has one. Some televisions, including every Fire TV, have none, and the line is not shown; see Adding a playlist on a Fire TV for the ways that work there.
From version 0.3.49: From your phone also sends a playlist file, an .m3u or an
.orbitlist, from the phone to the television, and the web panel's Import
from file (Premium) takes the same files from a browser.
Step 3: Who is connecting? (Xtream Codes and Stalker)
- Username and Password. For Xtream Codes they are required, unless you log in with a MAC address. For Stalker they are optional (“if required”).
- MAC / MAG Android ID: the device identity your provider registered. Required for Stalker.
- Serial number (optional) and MAG model, for portals that check them.
Stalker playlists also have a MAG firmware profile with the emulated box's details. Leave it alone unless your provider tells you otherwise.
Step 4: Name and options
- XMLTV address · optional: a TV guide link, if your provider gave you one separately (M3U and Xtream Codes).
- Playlist name: how the playlist appears in the app. If you leave it empty, the type is used.
- Proxy (optional):
http://host:portorsocks5://host:port, with an HTTP proxy username and password if needed. It is used for the playlist, portal, catalogues and EPG. Video through the proxy → direct opens the first video address through the proxy and then reads directly. SOCKS5 with a username and password is not supported. Leave the address empty for no proxy.
Step 5: Ready to add
“Check the details, then add the playlist.” Choose Add playlist. The channels load and the guide opens.
Managing your playlists
Settings → Sources → Manage playlists lists every playlist with its channel count. A disabled playlist is marked with ○. Choose one to see its actions:
| Action | What it does |
|---|---|
| Refresh | Loads the channel list again from the provider. |
| Edit | Opens the wizard with the saved details (the type is not asked again). |
| Export | Saves this playlist to an .orbitlist file with a password. See Export, Import and backups. |
| Proxy · on/off | Sets or removes the proxy for this playlist. |
| Advanced settings | Device IDs, time zone, User-Agent, HTTP headers (JSON) and a metadata proxy, for providers that need them. After saving, refresh the playlist separately. |
| MAG firmware profile | Stalker only: the emulated box's firmware details. |
| Additional EPG sources | Extra TV guide (XMLTV) links for this playlist (Premium). |
| Disable / Enable | Hides the playlist without deleting it, or brings it back. |
| Remove | Deletes the playlist from the app, after you confirm with Remove playlist. |
Settings → Sources → Refresh all playlists refreshes every playlist in turn (“Refreshing 1 / 3”).
Import an .orbitlist file
An .orbitlist file holds one playlist, protected by a password, made with Export (see Export, Import and backups).
- Add playlist → Import.
- Browse to the file (on the device, a USB drive or a network folder) and choose it. Internal storage shows only the files OrbitAI.tv saved there, as above.
- Enter the password it was exported with and choose Import.
The playlist is added as a new one and loaded like any other. If the password is wrong or the file is damaged, you see “Invalid password, damaged file or unsupported version.”
Common messages
| Message | What to check |
|---|---|
| The #EXTM3U header is missing. | The address does not point to an M3U playlist. |
| This is an HLS stream, not a channel list. | You entered a single channel's stream address, not the playlist. |
| The Xtream subscription has expired. | Your provider account has expired. |
| Invalid or inactive Xtream profile | Username, password or server address is wrong, or the account is inactive. |
| A valid MAC address or MAG Android ID is required | Stalker needs the MAC your provider registered. |
| The portal refused access | The portal did not accept the MAC or login. Check with your provider. |
| No connection to the provider | Check the address and your internet connection. |