How IPTV Catch-up / TimeShift Works — Archives vs DVR

Missed the first ten minutes of a match? Walked away during the news? In IPTV, catch-up (often labeled TimeShift, TV archive, or replay) is the feature that lets you open a live channel and scrub backward into a rolling window the provider already stored. This guide explains how that pipeline works, what GridStreamr’s Premium TimeShift UI does with it, and why it is not the same thing as Home DVR.

The mental model in one paragraph

Your provider’s panel keeps a short-term recording buffer for selected live channels (hours to days). The Xtream Codes API advertises which channels have archive and how to request a past window. GridStreamr Premium reads those flags, lists programmes (often guided by EPG), builds the playback URL, and lets you scrub — then jump Back to Live. If the panel never enabled archive, no app can invent it.

Blog sibling: How to use TimeShift IPTV. Feature page: TimeShift.

Catch-up vs related features

People say “DVR” when they mean catch-up. Be precise: catch-up dies when the provider’s window slides; Home DVR files stay until you delete them.

What the Xtream archive actually exposes

When you add an Xtream Codes account, capable panels can return:

• Per-channel archive enabled flags
• Archive duration (e.g. 24h, 72h, 7 days)
• Endpoints to fetch a programme starting at a timestamp
• Sometimes programme lists tied to provider EPG

GridStreamr does not extend those windows. If the panel says 24 hours, minute 25 yesterday is gone.

How to use TimeShift in GridStreamr

Prerequisites

1. Premium (or active trial) — TimeShift is not on Free
2. An Xtream source (not M3U-only) with archive on the target channel
3. A channel that shows TimeShift as available (not greyed out)

Steps

1. Open a live channel from Live TV or a Smart Collection
2. Tap TimeShift / catch-up in the player
3. Pick a day, then a programme
4. Playback starts from the beginning (or a listed start)
5. Scrub with the timeline / remote rewind & fast-forward
6. Tap Back to Live when you are caught up

On Android TV, the same flow is remote-friendly: open catch-up, scrub, return to live.

Why the button stays grey

Grey is usually honesty, not a bug.

EPG’s role (and its limits)

A good EPG makes catch-up browsable — programme titles instead of raw timestamps. Mapping Global EPG or XMLTV (add EPG guide) improves the list UI.

EPG does not:

• Create archive where the panel has none
• Guarantee titles match the bytes you will hear
• Replace provider archive depth settings

Think of EPG as the menu; archive is the kitchen. Empty kitchen → pretty menu still means no meal.

Smart Collections and multi-provider catch-up

Channels pulled from Xtream into Smart Collections keep archive support when the upstream account exposes it. That means:

• Your living-room shortlist can still TimeShift
• Merging two providers (combine Xtream guide) can give catch-up on sports from A and news from B
• Shares to family via virtual credentials only help if those shared channels still resolve archive through your connected sources under your authorization rules

Catch-up quality issues (real-world)

1. Starts late / cuts early — provider segment boundaries, not player scrub math alone
2. Audio/video desync in archive only — upstream encode; try live to compare
3. Works on phone, fails on TV — retry; confirm Premium entitlement synced
4. Sports blackout windows — some panels omit archive for rights-heavy events
5. VPN path differs for archive URLs — test without VPN once

When you should use Home DVR instead

Choose Home DVR when:

• You need shows after the provider window expires
• You want a personal library independent of panel churn
• You record series patterns to NAS (Docker / Synology guide)
• Catch-up is unavailable on the channels you care about

Premium can use both: TimeShift for “what did I miss tonight?”, DVR for “keep this weekend’s race.”

Platform notes

Responsible use

Catch-up is still access to your provider’s streams under your subscription terms. Do not treat archive as a content store to redistribute. Prefer secure sharing of curated live lineups over password leakage, and follow local law and provider contracts.

Quick decision tree

Need last night’s show?
 ├─ Channel has Xtream archive + Premium → use TimeShift
 ├─ No archive, but you care long-term → schedule Home DVR next time
 └─ Only M3U, no archive API → live only (or DVR if you record live)

Verification checklist

• Premium active
• Source is Xtream with known archive channels
• TimeShift opens and lists at least one past programme
• Scrub + Back to Live works
• You understand DVR is separate if you need permanent copies

Next reading

• TimeShift feature
• Home IPTV DVR
• How Xtream Codes works
• Add EPG to an IPTV playlist

Related reading

• TimeShift
• Xtream Codes
• IPTV DVR
• Global EPG
• Smart Collections
• Documentation