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.

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.
| Approach | What it does | Where media lives |
|---|---|---|
| TimeShift | Replay from Xtream provider archive when the channel supports catch-up | Provider servers |
| Home DVR | Schedule/record from Smart Collections | Your disk (NAS/PC) |
| Cloud DVR services | Vendor stores recordings for a fee | Their 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
- Download from /download/dvr (
.pkg,.exe, or Docker) - Leave the service running on your LAN (port 8787)
- On your phone: Settings → DVR → Find on Wi‑Fi (or enter
http://YOUR-LAN-IP:8787) - 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:
- Open a Smart Collection with the channels or titles you care about
- Tap a live channel (or use record while you're already watching in the player)
- Pick a programme from the guide when EPG is mapped, or set a custom start/end
- 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
| Platform | Method |
|---|---|
| macOS | Apple silicon / Intel .pkg |
| Windows | x64 Setup.exe (allow firewall for 8787) |
| Synology / Unraid / Linux | Docker amd64 or arm64 — see Docker/Synology guide |
| Windows / Mac / Linux deep dives | Windows, 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 Relay | Without 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
| Free | Premium | |
|---|---|---|
| Download DVR | ✓ | ✓ |
| Pair / schedule / manage jobs | — | ✓ |
| Smart Collections to record from | 1 × 20 entries | Unlimited × 2,000 |
Confirm trial terms in-app and on pricing.
Getting started checklist
- Curate a short Sports or News Smart Collection on your phone
- Install DVR on an always-on host
- Pair from Settings → DVR (Wi‑Fi discovery or LAN IP:8787)
- From that collection (or the player), schedule a five-minute test recording
- Confirm the job in the app and the file on disk
Product page: Home IPTV DVR.
Failure modes (and what they mean)
| Symptom | Likely cause |
|---|---|
| Pairing cannot find DVR | Wrong LAN IP, port 8787 blocked, host asleep, Docker bridge networking |
| Job starts then fails | Upstream stream error, provider concurrent limit, bad collection entry |
| Files missing | Wrong recordings volume mapping, disk full |
| Remote schedule works, playback does not | Expected — 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
Self-Hosting IPTV with Jellyfin — One Client, Two Libraries
How you can run Jellyfin for your file library beside IPTV Smart Collections in GridStreamr Premium — without treating Jellyfin as an Xtream panel.
Readarrow_forwardHow to Catch Up on Live TV with TimeShift in GridStreamr
TimeShift lets you browse and watch past live TV programmes, no recording needed. Here's how it works in GridStreamr and what your provider needs to support.
Readarrow_forwardAI for IPTV Playlist Cleanup — Review, Don't Autopilot
How AI-assisted IPTV cleanup should work for you: names, logos and tags with human review. GridStreamr AI Live Channels Enrichment, credits, and how it differs from TMDB or a chat assistant.
Readarrow_forward