Updates
How the desktop app keeps itself up to date.
On this page
The cliply desktop app updates itself automatically. When a new version is available, the app downloads it in the background, verifies it, and prompts you to install. You can also trigger an update check manually.
How automatic updates work
Every time the app launches, it checks a cliply-hosted endpoint for a newer version. If one is available:
- The app downloads the update package in the background.
- The download is cryptographically verified using a signature baked into the app binary. A file that fails verification is discarded.
- A notification or prompt appears asking you to install the update and restart.
- After restart, you are running the new version.
If no update is available, or if the check fails due to a network issue, the app continues as normal.
Update channel
Updates come from cliply's release server. The app checks the endpoint:
https://cliply.video/api/desktop/update
This endpoint compares your current version against the latest published release and returns a signed download URL when a newer version exists.
Checking for updates manually
Open the app's About window (from the menu bar) to see your current version number and to trigger a manual update check.
What if the update fails
| Symptom | Likely cause | Fix |
|---|---|---|
| Update downloads but does not install | Insufficient disk space | Free up space and retry |
| Update check never completes | Network issue or firewall blocking the endpoint | Check your connection; the app will retry on next launch |
| App version is not changing | Already on the latest version | No action needed |
If the app is stuck on an old version and updates are not being offered, contact support with your current version number (visible in the About window).
The xattr -d com.apple.quarantine step described in the install guide is required only once, for the initial download. Updates delivered by the auto-updater are handled differently and do not need the quarantine flag removed.
Version numbering
The desktop app uses semantic versioning (major.minor.patch). You can see the current version in the About window. Release notes for each version are published on the cliply website.