Този раздел е достъпен само на английски език.

Съдържание

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.”

ChoiceUse it when your provider gave you
M3U playlistA playlist link, with an optional TV guide (XMLTV) link.
Xtream CodesA server address with a username and password, or MAC access.
Stalker PortalA portal address and a MAC device identity (MAG).
From your phoneAny 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.
ImportAn .orbitlist file made with Export on another device. See “Import an .orbitlist file” below.
CancelCloses 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 .php file.

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:port or socks5://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:

ActionWhat it does
RefreshLoads the channel list again from the provider.
EditOpens the wizard with the saved details (the type is not asked again).
ExportSaves this playlist to an .orbitlist file with a password. See Export, Import and backups.
Proxy · on/offSets or removes the proxy for this playlist.
Advanced settingsDevice 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 profileStalker only: the emulated box's firmware details.
Additional EPG sourcesExtra TV guide (XMLTV) links for this playlist (Premium).
Disable / EnableHides the playlist without deleting it, or brings it back.
RemoveDeletes 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).

  1. Add playlist → Import.
  2. 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.
  3. 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

MessageWhat 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 profileUsername, password or server address is wrong, or the account is inactive.
A valid MAC address or MAG Android ID is requiredStalker needs the MAC your provider registered.
The portal refused accessThe portal did not accept the MAC or login. Check with your provider.
No connection to the providerCheck the address and your internet connection.