What an error message can tell you
Not the cause, usually — but reliably the layer. That is worth a great deal, because it stops you changing settings at the wrong end.
The chain runs: your credentials, then the player, then the device, then your network, then the service. Our troubleshooting guide works through these in order. An error message is a shortcut into the right layer rather than a diagnosis.
Quick reference
The codes you are most likely to meet, and which end of the chain each one sends you to. The sections below go through the reasoning behind them.
| Code or message | Points at | First thing to do |
|---|---|---|
| 401 Unauthorised | Your credentials | Re-enter the details, checking for a trailing space; confirm the subscription is current |
| 403 Forbidden | Concurrent streams | Stop playback on other devices, then retry |
| 404 on one channel | That channel | Nothing — the channel moved or ended |
| 404 on every channel | Your playlist address | Re-check the URL or login details you entered |
| 400 Bad Request | The address itself | Look for a malformed or truncated playlist URL |
| Connection timed out | Network path | Test whether anything else on the device reaches the internet |
| 500, 502, 503, 504 | The server | Wait, then report if it persists. Change nothing locally |
| Unsupported format / decoder error | The device | Switch hardware and software decoding, or try another player |
| Black screen, no message | Unknown — usually connection | Compare against other channels to narrow it |
Many players show a friendly message and hide the code that produced it. Where a player offers a stream information panel or a log view, the underlying status is usually visible there, and it is worth finding before changing settings — see reading the stream info overlay.
Authentication and access messages
Anything mentioning authorisation, credentials, expiry, or a 401 or 403 code points at the credentials layer.
- 401, unauthorised — the details were rejected. Usually a typing error, or a subscription that has ended.
- 403, forbidden — the details were understood but access refused. Often the concurrent-stream limit: something else is already playing. See IPTV on multiple devices.
- "Account expired" — usually literal.
The distinction matters: 401 means try your details again, 403 means your details are fine and something else is in the way.
Not found and gone
A 404 means the address was reached but there is nothing at it. On a single channel this normally means that channel has moved or been removed — your setup is fine and there is nothing to fix at your end.
A 404 on every channel is different, and suggests the playlist address itself is wrong or has changed.
The distinction is the same one worth making everywhere: one channel is a channel, all channels is your setup.
Timeouts and connection failures
Messages about connection timeouts, "could not connect", or a network error point at the network layer — either yours or the path to the server.
A useful test: does anything else on the same device reach the internet normally? If yes, your connection is working and the problem is more specific. If the whole device struggles, start with the network, using Wi-Fi optimisation or a cable.
Timeouts that appear only at particular times of day are usually congestion rather than a fault.
Playback and format errors
Messages naming the decoder, an unsupported format, or simply "playback error" while the connection is clearly fine point at the device.
The signature is that the stream is arriving — the player found it and started — but something cannot process it. On some channels only, this is very often codec support, covered in H.264 vs H.265. Switching from software to hardware decoding, or trying another player, are the fastest tests.
Server errors
500 and similar codes are the server reporting its own problem. There is nothing to fix at your end.
The correct response is to check whether it affects one channel or all of them, wait a few minutes, and report it if it persists. Reconfiguring your player in response to a server error only risks breaking a working setup.
When there is no message at all
Often the most frustrating case: a black screen, a spinner, or the player returning to the channel list without explanation.
Treat silence as information. It usually means the player never got far enough to receive an error, which points at connection or address rather than at content. Work the layers in order rather than guessing, and check whether other channels behave the same way — that one comparison narrows it more than any message would.
Frequently asked questions
What does a 403 error mean on IPTV?
Your credentials were accepted but access was refused. The most common reason is the concurrent-stream limit — something else is already playing on your subscription.
What is the difference between a 401 and a 403?
A 401 means the details themselves were rejected, so check for typing errors or an expired subscription. A 403 means the details are fine but something else is blocking access.
One channel gives a 404 but the rest work. What is wrong?
That channel has moved or been removed. Your setup is fine. A 404 on every channel would instead suggest the playlist address is wrong.
What should I do about a 500 error?
Nothing at your end — it is the server reporting its own problem. Check whether it affects one channel or all, wait a few minutes, and report it if it continues.