immichBEAM v0.5.0-beta.1
Pre-release
Pre-release
Beta release — this is the first build with in-app auto-update. Help us test it: install this version, and when v0.5.0-beta.2 ships, the app should detect and offer the update automatically.
What's New
Similar Photos
- Lightbox now shows a Similar Photos carousel below the detail panel, powered by Immich's CLIP embedding search
- Click a similar photo to navigate directly to it
Server Capability Detection
- The app now queries
GET /api/server/featureson connection and gates UI features accordingly - Map tab hidden when the server has maps disabled
- Smart search disabled when CLIP is off
- People tab always visible (face data persists even when ML is paused)
In-App Auto-Update
- Background update check on launch (24-hour cooldown)
- Sidebar dot + toast notification when a new version is available
- One-click download and install from About → Updates
- Stable / Beta channel picker — switching channels auto-checks for updates
- If a download fails, the pending update is preserved so you can retry without re-checking
Security Hardening
validate_destination()blocks writes to sensitive directories (.ssh,.gnupg,.aws,.config, etc.) and direct$HOMEwritesvalidate_folder_path()andvalidate_watched_folders()block dangerous extensions (.pem,.key,.env)- UUID validation on all
immichasset://protocol routes (prevents path traversal) - Streaming body caps: 64 MB for thumbnails, 256 MB for proxied video
Browse & Search Improvements
- Unified
AssetBrowsercomponent replaces fragmented browse views - Smart / Filename / Description / OCR scope picker for search
- Pop-out calendar with Week / Month / Year / Custom date presets
- Paginated People view with count badges
- Sticky filter headers with per-view scroll containers
- Video volume control with mute toggle
Overview Redesign
- Compact card layout with server storage, version, license, and member-since
- Clickable stats that navigate to filtered views
- Debounced remote refresh during sync (5-second cooldown)
Stability & Performance
- React Error Boundary prevents blank-window crashes
- DB retention pruning for history and stale hash cache
useStatusthrottled to prevent full-tree re-renders during sync- Atomic config saves via temp-file rename
- One-time DB migrations gated behind
PRAGMA user_version - 11 unused dependencies removed
Bug Fixes
- Fixed
ServerFeaturesserde:rename→aliasso feature flags reach the frontend correctly - Fixed Smart mode + filter interaction bugs (scope preservation, date filter gating)
- Fixed stuck progress bar on pause
- Fixed album count badge fallback
- Fixed calendar scroll lockup
- Darkened brand-600 to meet WCAG AA contrast (4.81:1)
Downloads
| Platform | File |
|---|---|
| macOS (Universal) | immichBEAM_0.5.0-1_universal.dmg |
| Windows x64 | immichBEAM_0.5.0-1_x64-setup.exe or .msi |
| Windows ARM | immichBEAM_0.5.0-1_arm64-setup.exe or .msi |
| Linux x64 (Debian/Ubuntu) | immichBEAM_0.5.0-1_amd64.deb |
| Linux ARM (Debian/Ubuntu) | immichBEAM_0.5.0-1_arm64.deb |
| Linux x64 (AppImage) | immichBEAM_0.5.0-1_amd64.AppImage |
| Linux ARM (AppImage) | immichBEAM_0.5.0-1_aarch64.AppImage |
| Linux x64 (RPM) | immichBEAM-0.5.0-1-1.x86_64.rpm |
| Linux ARM (RPM) | immichBEAM-0.5.0-1-1.aarch64.rpm |