| Problem | Likely Cause | Fix |
|---|---|---|
| Channels won't load | Typo in M3U/Xtream credentials, or expired subscription | Test M3U link in a browser; verify subscription is active |
| App crashes on open | Corrupted cache | Force-close, then delete and reinstall the app |
| Black screen on channel | Stream format or connectivity issue | Check internet connection, try a different channel |
| EPG not showing | Missing XMLTV URL (M3U setup only) | Add XMLTV URL under Settings → EPG Settings |
| Buffering / stuttering | Insufficient bandwidth | Check speed (15 Mbps HD / 50 Mbps 4K), switch to wired connection |
| App unresponsive on Apple TV | App froze | Double-click TV button, swipe up to force-close, reopen |
Channels won't load — the full checklist
- Copy your M3U URL and paste it into a web browser — it should immediately start downloading a file. If it doesn't, the link is broken or your subscription has expired.
- Double-check for typos if you typed your Xtream Codes credentials manually rather than pasting them.
- Confirm your internet connection is active on the device itself, not just your network generally.
- Contact your provider to confirm your subscription status if the above doesn't resolve it.
Persistent crashes
If force-closing and reopening doesn't help, a full reinstall clears any corrupted local cache: delete the app completely, restart your device, then reinstall from the App Store and re-add your playlist.
Still stuck?
For setup fundamentals and platform-specific guidance, see our main GSE Smart IPTV guide and Apple TV setup guide. If the issue is bandwidth-related, our bandwidth requirements guide covers exact speed thresholds.
Frequently Asked Questions — GSE Smart IPTV Not Working
Usually a typo in your M3U URL or Xtream Codes credentials, or your subscription needs renewal. Test the M3U link in a browser to check.
Force-close and reopen the app. If crashes persist, delete and reinstall it to clear corrupted cache data.
Usually a stream format or connectivity issue. Check your internet connection and try a different channel to isolate the cause.