Blog

IPTV DVR Explained — Record to Storage You Control

What an IPTV DVR is, how GridStreamr Home DVR differs from TimeShift and cloud lockers, and how you can pair Mac, Windows, Linux or Docker recording with Premium.

8 min read

Responsible use

GridStreamr does not provide IPTV channels, VOD, or playlists. You bring your own authorized Xtream Codes or M3U sources. You are responsible for complying with applicable terms, licenses, and local law.

You want to keep last night's match, a news special, or a movie from your collection — on your disk, not someone else's cloud. That is what IPTV DVR is for: recording live TV (and often VOD titles from your collections) onto hardware you control.

GridStreamr's answer is Home DVR — a small service you install on Mac, Windows, Linux or Docker, pair from the app, and schedule from curated Smart Collections.

DVR vs TimeShift vs "cloud DVR"

These three options solve different problems. Pick the one that matches what you actually need tonight.

ApproachWhat it doesWhere media lives
TimeShiftReplay from Xtream provider archive when the channel supports catch-upProvider servers
Home DVRSchedule/record from Smart CollectionsYour disk (NAS/PC)
Cloud DVR servicesVendor stores recordings for a feeTheir cloud

Use TimeShift when you missed the first half hour. Use Home DVR when you want a file that can outlive the archive window, sit next to Jellyfin, or survive a provider reshuffle.

Why self-hosted matters for IPTV

If you have been using IPTV for a while, you already know the pain points: playlists change overnight, concurrent-stream limits bite during sports, and cloud DVR subscriptions stack on top of a bill you already pay. Self-hosted DVR gives you:

  • Direct file access — copy, archive, or import elsewhere
  • No per-GB cloud fees beyond the disk you already own
  • Curation-aware recording — schedule from cleaned Smart Collections, not a 3,000-row warehouse

How GridStreamr Home DVR works

You install a small DVR service on a Mac, PC, or NAS — then you set up recordings from the GridStreamr mobile app, not by living in the local browser dashboard. The host just runs the jobs and writes files to your disk.

Pair once

  1. Download from /download/dvr (.pkg, .exe, or Docker)
  2. Leave the service running on your LAN (port 8787)
  3. On your phone: Settings → DVR → Find on Wi‑Fi (or enter http://YOUR-LAN-IP:8787)
  4. Enter the one-time pairing code from the DVR host and finish Premium pairing

After that, your phone is the remote for scheduling. Closing a browser tab on the host does not stop recordings — as long as the machine is awake and the stream is reachable, jobs keep going.

Schedule from the mobile app

This is the everyday path:

  1. Open a Smart Collection with the channels or titles you care about
  2. Tap a live channel (or use record while you're already watching in the player)
  3. Pick a programme from the guide when EPG is mapped, or set a custom start/end
  4. Confirm the job — it lands on your paired DVR host

You can also browse channels from the in-app DVR picker, record now, schedule one-shots, or set a custom window for repeats where the schedule sheet allows it. Away from home, Cloud Relay keeps that control in your pocket without exposing the DVR to the internet.

What the local dashboard is for

The browser UI at http://YOUR-LAN-IP:8787 is useful for install checks, storage path, logs, and the occasional manual job. You do not need it open to record from your phone day to day.

Install options

PlatformMethod
macOSApple silicon / Intel .pkg
Windowsx64 Setup.exe (allow firewall for 8787)
Synology / Unraid / LinuxDocker amd64 or arm64 — see Docker/Synology guide
Windows / Mac / Linux deep divesWindows, Mac, Linux

Prefer Ethernet and a DHCP reservation for the host. Sleeping laptops miss scheduled jobs.

What you can record

From the app, against paired Smart Collections, you can record:

  • Live TV channels from your Xtream or M3U sources
  • Movies and series titles exposed through those collections
  • Guide-based jobs when EPG is mapped, or custom time windows

We don't invent streams. If a channel is broken in the collection, the recording job fails the same way live playback would.

Cloud Relay — private DVR, remote control

From a security perspective, Cloud Relay is what lets you keep Home DVR fully private. Your recorder never needs inbound ports, port forwarding, or a public IP. It stays on your LAN; the host only opens an outbound secure tunnel for control.

That is the whole difference versus exposing a dashboard to the internet: you still get almost every remote operation you need — schedule, monitor, cancel, check that the host is online — while playback and file download stay off Relay. Recordings never leave your disk through Cloud Relay.

With Cloud RelayWithout opening the DVR to the internet
Schedule / change / cancel jobs from the phone
See queued, running, failed, completed status
Confirm the host is reachable while traveling
Play or download finished recordings✗ — LAN, VPN home, or your own secured URL

No cloud vault. No streaming CDN. Just control messages — so your DVR can stay locked down.

Storage realism

HD sports fills disks fast. Size your volumes from typical bitrate × hours × retention weeks. Put recordings on a dedicated share, not the OS volume. If you also run Jellyfin, pointing a library folder at the recordings path is a common homelab pattern — see Jellyfin integration.

Rights and responsibility

Only record what your subscription and local law allow. Do not redistribute recordings. Software cannot grant content rights.

Free vs Premium

FreePremium
Download DVR
Pair / schedule / manage jobs
Smart Collections to record from1 × 20 entriesUnlimited × 2,000

Confirm trial terms in-app and on pricing.

Getting started checklist

  1. Curate a short Sports or News Smart Collection on your phone
  2. Install DVR on an always-on host
  3. Pair from Settings → DVR (Wi‑Fi discovery or LAN IP:8787)
  4. From that collection (or the player), schedule a five-minute test recording
  5. Confirm the job in the app and the file on disk

Product page: Home IPTV DVR.

Failure modes (and what they mean)

SymptomLikely cause
Pairing cannot find DVRWrong LAN IP, port 8787 blocked, host asleep, Docker bridge networking
Job starts then failsUpstream stream error, provider concurrent limit, bad collection entry
Files missingWrong recordings volume mapping, disk full
Remote schedule works, playback does notExpected — Cloud Relay keeps the DVR private; playback stays on LAN/VPN

Homelab placement

  • NAS Docker when the NAS is already always-on
  • Mini-PC when you want GPU-less simplicity and a spare box
  • Avoid relying on a gaming laptop that sleeps mid-match

Unraid users: Unraid DVR guide when available in your docs set; otherwise follow the Docker patterns in the Synology guide.

Pairing with TimeShift

Some nights you TimeShift the first half and DVR the whole event for later. They complement each other — they do not replace each other. See TimeShift feature.

Install Home DVR

Free download. Premium pairing. Recordings stay on your storage.

Frequently asked questions

Does GridStreamr provide channels to record?

No. Home DVR records streams from Smart Collections backed by your own authorized Xtream or M3U sources. GridStreamr does not supply IPTV content.

Is Home DVR free?

Installers and Docker images are free to download. Pairing and scheduling from the GridStreamr mobile app require Premium or an active trial.

Where are recordings stored?

On storage you configure on the DVR host — local disk, attached volume or NAS mount. GridStreamr does not upload recordings to a cloud locker.

How is DVR different from TimeShift?

TimeShift replays programmes from your Xtream provider's archive when that channel exposes catch-up. Home DVR writes files to your Mac, Windows, Linux or Docker storage so you can keep them beyond the provider archive window.

What is Cloud Relay for?

Cloud Relay lets you manage DVR jobs from the app while your recorder stays fully private on your LAN — no inbound ports, no public exposure. You can schedule, monitor, cancel and check host status remotely. It does not play or download recordings over the internet.

Which port does the DVR use?

Port 8787 by default for the dashboard and app pairing on your LAN.

Get started

Download gridstreamr free

Add your sources, build a Smart Collection, then upgrade to Premium in-app when you need more.

Related

Keep reading