IPTV Buffering & Playback Troubleshooting
Last updated: 22 October 2026
Channels Not Loading
If your channels are not appearing or the channel list is empty after adding a playlist, the issue is usually related to your playlist URL or a temporary problem with your IPTV provider.
- 1Verify your playlist URL or Xtream Codes credentials are correct — even a small typo will prevent loading.
- 2Check that your IPTV subscription with your provider is still active and has not expired.
- 3If you verify the playlist response yourself, keep its URL private: it may contain credentials. Do not submit it to public URL checkers.
- 4Go to Settings > Playlists & Providers (Android) or Settings > Setup & Configuration (iOS) and use Full Content Refresh or Refresh Playlist to force a fresh download of the channel list.
- 5If your provider changed its address, verify the replacement details before updating the source. Keep a record of your setup before removing anything.
IPTV Buffering: Identify the Cause Before Changing Settings
Buffering can come from the source, the network, the device or the player. A fast internet speed test does not measure every part of the route to a particular stream. Start with one affected channel, record what happens, and change one variable at a time. Aerial TV can have playback issues too; a comparison helps identify them rather than assuming the provider is responsible.
- 1Record whether playback never starts, repeatedly pauses to load, or looks jerky while audio continues. Note the channel, time, device and app version.
- 2Try another channel from the same source. Then, if available, try an independent source in the same app. This helps separate a single stream failure from a broader problem.
- 3Play the affected source in another compatible player on the same device and network. Stop the first session before testing the next so provider connection limits do not distort the result.
- 4Keep the device and source unchanged and compare another network, or compare Ethernet with Wi-Fi where the device supports it. A phone speed test elsewhere in the house is not the same test.
- 5If the failure occurs only in Aerial TV, note the selected player and available playback options, update the app and send the reproducible comparison to support.
How to Interpret Your Playback Tests
These results narrow the investigation; none proves the cause by itself.
- One channel fails in two players while others work — investigate that stream or its source first. Different codecs or authentication requirements can also matter.
- The same source works in another player on the same device and network — investigate Aerial playback settings, stream handling or an app issue. Include this result in a support report.
- Playback improves on another network — investigate Wi-Fi quality, routing or network restrictions. This does not by itself prove ISP throttling.
- All sources fail on one device but work on another — compare app versions, device capabilities and each device’s network connection.
- A stream stops when another household member starts watching — check the source service’s simultaneous-connection allowance. An Aerial Family entitlement does not increase a provider’s stream limit.
Buffering, Judder and Format Problems Are Different
A loading indicator or repeated pauses can suggest that playback is waiting for data. Uneven motion without a loading pause can involve frame timing or decoding. Missing audio, a black picture or an immediate playback error can involve stream format, audio output or authorisation. Describe the actual symptom rather than treating every failure as slow internet.
- Where your Apple-platform build offers a Default Player setting, compare an available alternative with the same stream. Keep a note of the original choice and restore it if the test does not help.
- For Plex, Jellyfin or Emby, compare the server’s own client and check whether the server reports direct playback or transcoding. If you manage Jellyfin, its official troubleshooting guide explains where to inspect playback and FFmpeg logs.
- If you already use a VPN, a comparison with it disconnected can help isolate the route. Neither enabling nor disabling a VPN is a universal buffering fix.
- A stale or expired video URL can prevent playback. Check source access and use its normal refresh before considering cache removal. Clearing cache cannot repair an unavailable stream.
Channels Play but the TV Guide Is Empty
The schedule feed and video stream are separate. Check the source’s EPG URL, guide refresh, channel matching and device time before removing a working playlist.
App Crashes or Freezes
If Aerial TV is crashing on launch or freezing during use, try the following steps to resolve the issue.
- 1Make sure you are running the latest version of Aerial TV. Open the App Store or Google Play Store and check for updates.
- 2Force close the app completely, then reopen it.
- 3Go to Settings > Data & Storage and tap Clear Cache to remove any corrupted cached data.
- 4Restart your device to clear any system-level issues that may be affecting performance.
- 5If the problem persists, try deleting and reinstalling the app. Your subscription can be restored after reinstallation.
Subscription Not Recognized
If you are subscribed but the app is showing the free tier or prompting you to subscribe, your purchase may need to be restored or verified with the App Store or Google Play.
- 1Open Aerial TV and go to Settings > Subscription.
- 2Tap Restore Purchases to re-verify your subscription with the store.
- 3Ensure you are signed in with the same Apple ID or Google account that was used to purchase the subscription.
- 4Check that your subscription is still active in your device's subscription management settings.
- 5If restoration fails, restart the app and try again — store verification can occasionally experience temporary delays.
Cloud Sync Not Working
Cloud Sync uses your Aerial TV account and an active entitlement. Both Solo and Family support syncing your own devices; it does not require every device to share an iCloud or Google account. Family members have independent accounts and histories.
- 1Compare the signed-in Aerial TV account on both devices and use the original sign-in method.
- 2Select the same profile when checking favourites or watch progress.
- 3Confirm the account has an active entitlement and both devices have internet access. Follow any sign-in or sync message in the app.
- 4For missing resume progress, stop playback on the first device and allow saved progress to sync before checking the same movie or episode on the second.
- 5If a synced source will not play, check its server or provider access separately. Synced credentials do not make an offline server reachable.
Trakt Connection Issues
If you are having trouble connecting your Trakt account or your watch history is not syncing, try these steps.
- 1Ensure you have a valid Trakt.tv account. Create one at trakt.tv if needed.
- 2The activation code expires after 10 minutes. If it expires, cancel and tap "Connect with Trakt" again to get a new code.
- 3Make sure you complete the authorization on the Trakt website — the app waits for you to enter the code and approve the connection.
- 4On Smart TVs, use another device (phone or computer) to visit the Trakt activation URL and enter the code shown on your TV.
- 5If sync seems stuck, go to Settings > Integrations > Trakt (Android) or Settings > Trakt (iOS) and tap "Sync Now" to trigger a manual sync.
- 6Check that "Sync watch history" and "Auto-scrobble" are enabled if you want progress and history to sync.
Contacting Support
If none of the above solutions resolve your issue, the Aerial TV support team is here to help. When reaching out, providing detailed information will help us diagnose and resolve your problem faster.
- Email support at the address listed on the Aerial TV website or in the app under Settings > About.
- Include your device model and operating system version (e.g., iPhone 16, iOS 18.3 or Pixel 8, Android 14).
- Describe the issue in detail — what you were doing, what happened, and any error messages you saw.
- Mention whether the issue is reproducible or intermittent.
- If the issue involves playback, note which player you are using (built-in or VLC) and whether the problem affects all channels or specific ones.
- Never share your IPTV provider credentials in the initial support email — we will request them securely if needed.