1. What happens while loading
Starting an IPTV channel is not a single connection. The app fetches the stream playlist, the provider often spins up the transcoder only at that point, the first video segments arrive after 3-4 seconds, and the decoder needs a keyframe before it can show anything. A healthy channel usually starts in 2-5 seconds. IPappTV watches this process with three watchdogs:
- Startup watchdog. If start-up buffering lasts 5 seconds without a first frame, the attempt counts as failed and the ladder moves on: reconnect, then the other decoder (the third attempt gets a 6 s window). This applies to start-up only - a stall while watching does not restart the channel from scratch.
- Dead-air watchdog. The player can stop idle: not buffering, no error, showing nothing. After 8 seconds of such silence the app shows a message with the latest diagnostics instead of leaving a black rectangle.
- Freeze watchdog - described in the article on the frozen picture.
Once the attempts are exhausted, the message includes what the player managed to learn about the stream: video codec and resolution, audio codec and channel count, or "no track detected". Copy that line before writing to the provider or to us - it says exactly where things stopped.
2. Network error vs stream error
The app distinguishes two kinds of failure and takes different paths:
Network error - the server refused the connection, dropped it, or answered with an HTTP 4xx/5xx status. Changing the decoder cannot help, so the app changes the identifier it presents to the server (User-Agent). Some IPTV panels block unknown player names; the app tries three identifiers in turn, starting with the one VLC uses. If the channel only started on the second one, the provider filters by player name.
Decoding error - data arrived, but the player cannot play it. Here the decoder ladder applies: reconnect, then FFmpeg.
There is a third case, with no error at all: a redirect from https to http. Panels often redirect the stream to an unencrypted server. The app allows this - Android's standard player rejects such redirects, which is why the channel "spins" forever in other apps even though it works in VLC.
3. Order of checks
- Do other channels from this list work? If none do, the problem is the account with the provider (expired, concurrent-connection limit, IP block) or your connection. Refresh the list: channel list menu → "Refresh list and EPG". Providers change server addresses, and a stale copy of the list points nowhere.
- Does this channel work in VLC? Install VLC on the same device and open the same list there. If the channel fails there too - it is the provider. If it works, read on.
- Read the message. "Could not connect to the channel server" is network - see section 4. A line with codecs or "no track detected" is the stream - see section 5.
- Connection limit. Most IPTV accounts allow one stream at a time. A channel open on the phone blocks the TV, and vice versa. Close the player on the other device - including in the background.
4. When the message is about the connection
- The server rejects all three identifiers - the provider allows only its own app. Rare, but it happens. There is no workaround; we do not plan to impersonate specific apps.
- The channel plays for a while and drops - usually a session timeout or an overloaded server. Raise the buffer in Settings (default 2.5 s); on a poor connection 5-8 s helps (range 1-10 s) at the cost of slower channel switching.
5. When the message is about the stream
- "video: no track detected", audio present - a radio channel, or a stream where the provider disabled video. Nothing to do in the app.
- A video description, e.g. "video/avc 1920x1080", but no picture - the hardware decoder did not accept the format. Set the software decoder for this channel: down arrow → decoder → "Always software (FFmpeg)".
- "video/hevc" on an older device - no hardware HEVC (H.265) decoder. FFmpeg copes with 1080p, unlikely with 4K.
- DRM-protected stream - unsupported; the message will report a decoding error on every attempt.
6. When it does not help
Write to kontakt@ipapptv.com with the message text (the codec line), device model, Android version and whether the channel works in VLC. No stream addresses and no credentials - they are not needed for diagnosis, and we do not want to store them.