playlist_add

IPTV Playlists

Last updated: August 2026

What Are Playlists?

A playlist is how Aerial TV connects to your IPTV service. Your IPTV provider will supply you with either an M3U/M3U8 playlist URL or Xtream Codes API credentials. This playlist tells Aerial TV where to find your live channels, movies, and TV series. Think of it as the key that unlocks all the content your provider offers.

  • M3U / M3U8 URL — A single web address that contains your full channel and content lineup. This is the most common format.
  • Xtream Codes API — A set of three credentials (server URL, username, and password) that connects to your provider's API. This format often provides richer metadata, EPG data, and catch-up TV support.
info
Note: Aerial TV does not provide any IPTV content. You must have an active subscription with an IPTV service provider to obtain playlist credentials.

Adding an M3U / M3U8 Playlist

If your IPTV provider gave you a URL ending in .m3u or .m3u8, follow these steps to add it to Aerial TV.

  1. 1Open Aerial TV and navigate to Settings.
  2. 2Tap on Playlists (or Manage Playlists).
  3. 3Tap the Add Playlist button.
  4. 4Select M3U URL as the playlist type.
  5. 5Paste the full M3U/M3U8 URL provided by your IPTV service into the URL field.
  6. 6Give your playlist a name (e.g., "My IPTV Service") so you can identify it later.
  7. 7Tap Save. Aerial TV will connect to the URL and begin loading your channels and content.
lightbulb
Tip: Setting up on a Smart TV? Use QR Code Device Linking to transfer your playlist URL from your phone instead of typing it with the remote. Learn more
warning
Warning: Make sure you paste the complete URL exactly as provided. Even a single missing character will prevent the playlist from loading.

Adding an Xtream Codes API Playlist

Xtream Codes is a popular API format used by many IPTV providers. Instead of a single URL, you enter three separate fields: the server address, your username, and your password.

  1. 1Open Aerial TV and navigate to Settings.
  2. 2Tap on Playlists (or Manage Playlists).
  3. 3Tap the Add Playlist button.
  4. 4Select Xtream Codes API as the playlist type.
  5. 5Enter the Server URL provided by your IPTV service (e.g., http://provider.example.com:8080).
  6. 6Enter your Username.
  7. 7Enter your Password.
  8. 8Give your playlist a recognizable name.
  9. 9Tap Save. Aerial TV will authenticate with the server and load your content library.
info
Note: Xtream Codes connections often provide additional features such as catch-up TV, richer EPG data, and content metadata like movie posters and descriptions. If your provider supports both formats, Xtream Codes is generally the better choice.

Managing Multiple Playlists

Aerial TV supports multiple playlists, allowing you to connect to more than one IPTV service at the same time. This is useful if you subscribe to multiple providers or have separate playlists for different types of content.

  1. 1Navigate to Settings and tap Playlists.
  2. 2You will see a list of all your added playlists.
  3. 3Tap Add Playlist to add another service alongside your existing ones.
  4. 4Each playlist is loaded independently, so content from all active playlists is available throughout the app.
lightbulb
Tip: Give each playlist a clear, descriptive name so you can easily tell them apart when managing your subscriptions.

Switching, Editing, and Removing Playlists

You can manage your playlists at any time from the Settings screen. Switch between playlists to change which content is displayed, edit credentials if your provider issues new ones, or remove a playlist you no longer need.

  • Switch Playlist — Tap on a different playlist from your list to make it the active source. The app will reload with content from the selected playlist.
  • Edit Playlist — Tap the edit button (or swipe on the playlist) to update the name, URL, or credentials. This is useful when your provider changes server addresses.
  • Remove Playlist — Swipe left on a playlist and tap Delete, or use the edit button to remove it. This removes all associated data including favorites and watch history for that playlist.
warning
Warning: Removing a playlist will delete all favorites, watch history, and downloaded content associated with it. This action cannot be undone.

Refreshing Playlist Data

Your IPTV provider may update their channel lineup, add new movies, or change server configurations. Refreshing your playlist pulls the latest data from your provider so your content stays up to date.

  1. 1Navigate to Settings and tap Playlists.
  2. 2Tap on the playlist you want to refresh.
  3. 3Tap the Refresh button to pull the latest data from your provider.
  4. 4Wait for the refresh to complete. The app will update your channel list, movie library, and series catalog.
lightbulb
Tip: If channels suddenly stop working or you notice missing content, a playlist refresh is usually the first thing to try.