IPTV Catch-Up and Timeshift Explained

Most people think of IPTV as a straight replacement for live television — same channels, same schedule. But IPTV also supports catch-up TV and timeshift, which let you watch on your own schedule. Understanding how these features work — and exactly what limits them — saves a lot of frustrating troubleshooting.

What is IPTV catch-up?

IPTV catch-up — sometimes called replay TV or archive TV — lets you watch a programme that was broadcast in the past. Depending on the provider and channel, the available window typically ranges from a few hours up to 7 days. Instead of you pressing record, the provider's server records certain channels continuously and stores a rolling archive. Your player can then request any segment of that recorded stream.

In Xtream Codes-compatible players, catch-up usually appears as a clock or rewind icon next to a channel. Tapping it opens a calendar or EPG timeline view where you pick the programme you want. The player then requests a time-shifted stream URL from the provider's server and plays it back exactly like a live channel — no downloading, no waiting for a file.

What is IPTV timeshift?

Timeshift works on a currently airing stream: you can pause what is playing, rewind a few minutes, or skip forward to live again — all without leaving the channel. Some players label this feature "Live TV delay." It depends on the provider buffering a short rolling window of the live stream (typically minutes to an hour) on their end.

The difference from catch-up is scope. Timeshift gives you a small buffer around the present moment; catch-up gives you a multi-day archive of the past. Think of timeshift as a pause button and catch-up as the provider's full replay library.

How catch-up works under the hood

When your player loads the channel list via the Xtream API, each channel entry can include a tv_archive flag (0 or 1) and a tv_archive_duration value in days. A catch-up-aware player reads these flags and shows the archive icon only on channels that carry a positive flag. To actually play back past content, the player constructs a time-shifted stream URL — typically your normal stream URL with a timeshift or utc query parameter — and the provider's server streams the pre-recorded segment.

iptv.domains sits in the middle, presenting your provider's Xtream API through your own permanent username, password, and URL. The catch-up flags and time-shifted stream paths pass through transparently, which means if your provider supports catch-up on a channel, it works through your iptv.domains credentials exactly the same way. See the Xtream Codes guide for a broader look at how the protocol is structured.

How to use catch-up in your player

The exact steps differ slightly between players, but the general flow is the same across all Xtream Codes clients:

1. Open your player and navigate to the live channel list. Look for a clock, rewind, or archive icon on channels that support catch-up.
2. Tap or click the icon. A programme guide or timeline appears, showing what has aired over the available archive window.
3. Select the programme or exact time slot you want to watch. The player loads the time-shifted stream from the provider.
4. Use playback controls as normal — scrubbing, pausing, and resuming work like any video.

TiviMate on Android TV integrates catch-up directly into the EPG grid: tap any past programme in the guide and press play. It is one of the most seamless implementations available. The TiviMate Xtream Codes setup guide walks through the full configuration.

Why catch-up might not be working

Most catch-up problems come down to one of these four causes:

• Provider hasn't enabled it for that channel. The most common reason by far. Providers archive selectively to manage storage costs, so only popular channels tend to have catch-up. If there is no archive icon on a channel, the flag is absent in the Xtream response — no player can change that.
• The archive window has expired. Providers keep recordings for a fixed period, typically 3 to 7 days. Requesting something older than the provider's window returns no content.
• The player doesn't support Xtream catch-up. A basic M3U player with no Xtream integration won't read the tv_archive flag and won't show any catch-up UI, even if the provider offers it. Switch to a full Xtream Codes player.
• EPG not loaded. Many players surface catch-up through the programme guide. If your guide is blank or misconfigured, the catch-up timeline won't appear even if the underlying archive is live. If your guide is missing, the EPG not working guide covers the fix.

Catch-up vs VOD: key differences

Catch-up and Video on Demand (VOD) both let you watch content outside the live broadcast window, but they are different systems:

• Catch-up is automatically recorded live TV. Availability, timing, and duration are controlled entirely by the provider's recording setup. You access it through the live channel list.
• VOD is a curated catalogue of movies and series that the provider has uploaded and indexed separately. You browse it through the Movies or Series section of your player, independent of the live channel list.

If your VOD library — movies and series — is failing to load, that is a separate issue with a different set of causes. The IPTV VOD not loading guide covers those fixes specifically.