Home DVR companion
Home DVR downloads
Record, share and restream Live TV using storage you control. The companion runs on your computer or server, separately from the Odyssey player. Watch Party is for movies and series only, with independent provider playback and synchronised controls.
Language update ·
Beta downloads
The Windows and Linux releases now support 50 languages. Choose your language in the Home DVR dashboard. The Mac and Docker downloads below are the previous releases.
- Windows x64: Download (EXE). Requires .NET Framework 4.8. Use the system tray app to open settings, manage the service, configure your account and TLS, or open the dashboard in your browser. The installer and its files were verified. Testing on a Windows device is still pending. This beta installer is unsigned.
- Mac (Apple Silicon): Download (DMG) or download the app as a ZIP. The app was signed with Developer ID, notarized by Apple, and opened on a Mac mini. It includes a menu bar app and the arm64 runtime. Requires a Mac with Apple silicon and macOS 12 or later. Intel Macs are unsupported. Mac installation guide · Mac checksums · Mac release details.
- Linux x64: Download (TAR.GZ). Offline command-line installer with startup scripts and a browser dashboard. Requires a Debian 12 compatible environment with glibc 2.36 or later. Installation, media tools, service controls, and preservation of settings and recordings on upgrade were verified in an isolated Debian 12 environment. There is no graphical tray app.
- Docker (Linux amd64): Download (TAR) and Docker Compose configuration. Image loading, startup with PM2, media tools, restart, and clean shutdown were verified in an isolated environment.
For Windows and Linux, see the release notes, release details, and SHA-256 checksums. Before installing, read the installation guide, release details and limits by platform, and SHA-256 checksums for earlier releases. A checksum helps detect changes to a file; it does not verify the publisher. Keep your system protections enabled.
This software uses FFmpeg 9.0.1 under LGPLv3. For all four packages we provide the matching FFmpeg source and build log, third-party source archive, and license notices.
Your recording dashboard
The new dashboard keeps recordings, upcoming schedules, storage and source activity together. It retains the last successful view during a connection outage, marks stale status clearly and reconnects with bounded backoff. Recording actions are never automatically replayed after an uncertain response. Locking the dashboard clears the current account view.
DVR and Watch Party
Recording, sharing and restreaming are exclusively for Live TV. Watch Party is only for movies and series. Owner testing of complete real-device workflows remains pending.
- Live TV recording: start, stop and schedule Live TV recordings, then manage them on your own storage.
- Live TV sharing and restreaming: create, copy and revoke private Live TV links. These DVR workflows are exclusively for Live TV.
- Live TV readiness: shared Live TV playback waits for usable captured media.
- Watch Party: movies and series only. Each participant plays the title independently and directly from their own authorised provider.
- Watch Party synchronisation: synchronise playback controls and timing, including play, pause and seek. Movie and series media is not recorded, shared or restreamed through the DVR. Visible synchronisation across actual players remains a device QA check.
- Account access: paired devices use management-issued account and source authorization. Each user connects to their own companion.
- Dashboard: manage Live TV recordings, schedules and active Live TV links through the configured HTTPS browser address.
Codec, provider and receiving-player compatibility varies. Use only content you are authorized to record and share.
Before installation
- Choose durable storage with enough free space and a private directory owned by the service user. Back up existing configuration and recordings before maintenance.
- The service uses PM2 and binds to
0.0.0.0:3000. Keep that port free in its deployment namespace. - Provide a trusted HTTPS origin through the supported gateway or NGINX/Cloudflare configuration. Restrict direct backend access and keep credentials private.
- Complete account enrollment and login configuration. Installing the runtime does not grant source or account access.
- Desktop installation leaves DVR stopped. Start DVR explicitly when setup is ready; quitting the tray/menu app does not stop the server.
FAQ and troubleshooting
What should I expect when opening the Mac download?
The current Mac package is Developer ID signed and Apple notarized. macOS may show its normal first-open confirmation for an app downloaded from the internet. If an older download says it is damaged, download the current DMG above and copy its app to Applications. Do not disable Gatekeeper. The Windows beta remains unsigned and may display a publisher warning.
Can I replace my existing companion?
Keep a backup first and follow the matching update instructions. First-run installation refuses to overwrite an existing DVR. Maintenance controls preserve configuration and recordings but require their own owner QA before use on important data.
Why does a Live TV link fail or keep waiting?
Check that DVR is running, HTTPS is reachable, the link is valid, and the account can access the Live TV source. Slow capture, unsupported media or insufficient storage can delay readiness. Movie and series Watch Party instead uses each participant's independent provider playback with synchronised controls. Report the media format and timestamp without private tokens or links.
Where is the source code?
The matching dashboard source and desktop build scripts accompany the new Windows and Linux packages. The runtime source archives above remain the matching FFmpeg, Node, exact production npm package sources and Debian source packages for their unchanged bundled runtime and Docker components. See the source and rebuild guide and source verification record. Source collection is not a claim of legal or patent certification.
Sources for withdrawn builds
The old Linux preview's source, notices and build records, shared-library source supplement, and supplement checksum remain available for users who received those builds. They are not current installers and are not substitutes for this release's matching sources.
Support
Email [email protected] with your platform, package checksum, player build, media format and failure timestamp. Never send passwords, signing keys, tokens or private watch links.