Setup & troubleshooting
IPTV troubleshooting: common errors and how to fix them
By the IPTV Fox TV editorial teamLast reviewed 4 min read
Short answer
Most IPTV errors come from one of four places: the login details (a typo, wrong server URL or expired plan), the connection limit, the player app (an outdated version or an incompatible internal player), or the network. Check them in that order. If you still see buffering, use the separate buffering guide.

Quick diagnosis table
| What you see | Likely cause | What to try |
|---|---|---|
| "Invalid username or password" / "Auth failed" | Typo, wrong letter case, trailing space | Re-enter details; avoid copy-pasting extra spaces |
| "Unable to connect" / "Server error" | Wrong server URL, missing port, network down | Check http/https and :port; test another app or website |
| "Account expired" / "Inactive" | Plan ended or payment not processed | Check your renewal; contact support if you've paid |
| "Max connections reached" | Too many devices streaming | Close the app on other devices; check for unauthorized use |
| Login works but no channels | Playlist still loading, or app issue | Wait, refresh playlist, update or change app |
| One channel won't play | That stream is down or incompatible | Try later or switch the app's internal player |
| Black screen with sound | Decoder issue (often HEVC/4K) | Switch hardware/software decoding; try an HD version |
| Picture but no sound | Audio format not supported | Change the audio output or audio track in the app; check TV/soundbar settings |
| Guide empty or wrong times | EPG missing, IDs mismatched, time zone | See the EPG section below |
| App crashes or freezes | Low memory, corrupted cache, old version | Clear cache, update app, restart device |
Login and account errors
Login problems are the most common, and most of them come down to a small typo. Check that the server URL includes the right http:// or https:// prefix and any :port number, that the username and password match exactly (they're usually case-sensitive), and that no space slipped in at the end when you pasted. Our Xtream Codes login guide explains each field. If IPTV Smarters shows “failed to authorize”, follow our step-by-step fix for that error.
If the app says the account has expired and you've just paid, give activation the time your provider states, then contact support with your order confirmation.
"Max connections reached"
This means the number of devices streaming at once has hit your plan's limit. Close the player app completely on devices you're not using. Some apps keep a stream open in the background. If the error persists when nothing else is playing, your login may be in use somewhere else — ask support to reset it. Read using IPTV on multiple devices for more.
Channel and playback errors
- Only one channel fails: that stream may be temporarily unavailable. Try again later and report it if it continues.
- Many channels fail on one device but work on another: the issue is the app or device. Update the app, clear its cache or try a different internal player.
- Black screen with audio: your device may not decode that stream's video format in hardware. Toggle hardware and software decoding, or pick a lower-resolution version.
- Audio missing: some channels use surround-sound formats. Switch the app's audio track, or set your device's audio output to stereo/PCM to test.
Program guide errors
If the guide is empty, add or refresh the EPG. If times are off by a few hours, check your device's time zone first, then the app's EPG offset. If only some channels lack a guide, their IDs probably don't match the guide data — report those channels. Full details are in IPTV EPG explained.
App crashes and freezes
- Update the player app and your device's system software.
- Clear the app's cache (and, if needed, its data — you'll need to log in again).
- Restart the device to free memory.
- If problems continue on an older stick, try a lighter player app or a newer device.
Errors that appear right after an app update
If everything worked yesterday and an error appeared after the app updated, the update is the likeliest cause. Check the app's store page for a newer fix, clear the app's cache, and re-check settings that updates sometimes reset, such as the video player or decoder choice and the EPG time offset. If a playlist disappeared, re-add it with your original login details.
Checklist before contacting support
- Write down the exact error text, or take a photo of the screen.
- Note which device and player app you used, and the app version if you can find it.
- Try a second device or app, so you know whether the problem follows your account or stays with one device.
- Note the time it happened and which channels were affected.
- Check whether your subscription is still active and within its term.
With this information, support can usually tell straight away whether the issue is your login, your device or the service.
Buffering is a separate problem
If playback starts but keeps pausing, that's buffering rather than an error. Follow the IPTV buffering guide.
When to contact support
If you've worked through these checks, contact IPTV Fox TV. Include the exact error message (a photo of the screen helps), your device and app, the channels affected, and when it started. Never include your password in a message.
Frequently asked questions
What does “stream not found” mean?
The app can't reach that channel's stream address. The channel may be temporarily offline or may have moved, so refresh your playlist and try again later before reporting it.
Should I reinstall the app first?
Try clearing the cache and re-adding your login first. Reinstalling erases settings and only helps when the app itself is damaged.
Why does my IPTV say the server is not responding?
Usually the server URL or port is wrong, or your internet connection is down. Check the URL, then test your connection with another app.
Why do some IPTV channels not work?
Individual streams can be temporarily unavailable, or your app may not support that stream's format. Try another internal player or report the channel.
How do I reset my IPTV app?
Clear the app's cache and data from the device settings, then log in again with your details.
Sources
Related guides

How to fix IPTV buffering
Why IPTV buffers and how to fix it, step by step: restart, test your speed on the TV, improve Wi-Fi, adjust the player app, then contact support.
4 min read

Xtream Codes login explained
What an Xtream Codes login is, what the server URL, username and password mean, how to enter them in a player app, and how to fix login errors.
4 min read

What is an EPG in IPTV?
What an EPG (program guide) is in IPTV, how XMLTV guide data works, how to add an EPG URL, and how to fix a missing or wrong-time TV guide.
4 min read