5.0.0-beta.2 (2026-10-08)
⚠ BREAKING CHANGES
- The Influx field of MFA warnings is renamed from
warn-mfa_resend_error to warn-mfa_error - update queries and dashboards
using the old name.
Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com
- Boolean options configured through environment
variables are only enabled for the values true, 1, yes or on. Values
like false, 0, no, off or an empty value now disable the option (they
previously enabled it), any other value fails the startup.
Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com
Features
- [app] follow cloudkit continuation markers when paging queries (ef696c3), closes #364
- [app] move deleted assets into a trash folder with soft delete (a84e1f3), closes #314
- [app] sync hidden photos with --sync-hidden (1ec2146), closes #558
Bug Fixes
- [app] abort sync on file system errors while writing assets (b38b26d)
- [app] add support for wav files (77d9368), closes #143
- [app] apply asset modification time within the download queue (95e123b)
- [app] count received positions by assets only (69374aa), closes #364
- [app] detect library locks held by processes in other containers (b1bdc4b)
- [app] export WRITE_ALBUMS_STARTED status in influx metrics (2e13a93)
- [app] finish scheduled syncs of empty libraries (e93b922)
- [app] include cloudkit error details in failed photos requests (46ab637), closes #1071
- [app] keep syncing large libraries when download urls expire (f351477), closes #871
- [app] keep web base path when redirecting to the state view (e0f1840)
- [app] mask health check url, push endpoints and url credentials in crash reports (344e8bf)
- [app] mask session headers and cookies in crash reports (2a5ed34)
- [app] name influx warning fields after the runtime warning events (45bac9e)
- [app] parse the value of boolean environment variables (a8f9a42)
- [app] render web ui log incrementally (bce23a0), closes #1071
- [app] stop orphaned photos requests from crashing a failed sync (8362d86), closes #1071
- [app] surface errors while loading trusted phone numbers (56a6d15)
- [app] wait and retry throttled cloudkit requests (69a1f28), closes #1071
Tests
- [app] add soft delete options to docker help output (bbc9291)
- [app] allow more time for scheduling tests on slow runners (03fd090)
- [app] replace todo placeholders and cover icloud-photos module (a193e39)
- [app] update expected help text to current documentation links (aadcff7)
Documentation
- [docs] document download url expiry and file checksum format (341db8c)
- add v5 upgrade guide and node 26 requirement (9c0ce43), closes #1121
- describe the library lock heartbeat and harmonized warning names (c775607)
- document adp account in CLAUDE.md (b3898f1)
- drop dedicated v5 upgrade guide (780723f)
- fix outdated statements in CLAUDE.md (66e667e)
- map the full icloud api surface in api.md (7ad2264)
- refer to a mirrorless camera in the motivation (94cfd8a)
- store adp and prod trust tokens in their env files (7feff40)
- update developer docs and contributing guide (ce2a459)
- update user guides to match v5 behaviour (a787d98)