IPTV not working? M3U troubleshooting guide
When an IPTV playlist fails, the fault can be in the M3U syntax, the individual stream, your network, the player or a broadcaster restriction. Use this checklist to narrow it down.
1. Test another channel
If one entry fails but several others work, the problem is probably the individual stream URL rather than your player or internet connection.
2. Check the playlist text
Open the M3U file in a text editor. Look for malformed entries, missing URLs or accidental HTML copied from a web page. Our browser-based M3U checker can perform a basic local syntax inspection.
3. Try a second player
Testing the same playlist in another reputable player helps isolate app-specific issues. VLC is useful for desktop testing.
4. Distinguish buffering from a dead stream
A dead stream often fails immediately or returns an HTTP error. Buffering usually starts playback and then pauses repeatedly. Lower-quality variants can help if the broadcaster offers adaptive streaming and your connection is the bottleneck.
5. Consider geo-blocking and access conditions
Some broadcasters intentionally restrict streams to a country, official app or authenticated session. That is not something a player setting can legitimately “fix”. Use the broadcaster's authorised viewing method.
6. Refresh your EPG separately
If video works but programme data does not, the EPG feed or channel ID mapping is likely the issue. See the EPG guide.
Common symptoms
| Symptom | Likely cause |
|---|---|
| All channels fail | Playlist URL, network or player issue |
| Only one channel fails | Dead or changed stream URL |
| Works in browser, not player | Session headers, codec or player support |
| Video works, EPG empty | Guide source or tvg-id mismatch |
| Works in one country only | Geo-restriction |