immichBEAM v0.5.0-beta.2

What's New

Device Identity in Immich

immichBEAM now identifies itself in your Immich server's Authorized Devices list — you'll see "immichBEAM" with your platform (macOS, Windows, or Linux) instead of "Unknown".

Map Improvements

• Tooltip clipping fixed — hover previews near map edges now reposition automatically instead of getting cut off
• Cluster zoom loop fixed — clicking a large cluster no longer causes the map to zoom out and collapse repeatedly

Linux Compatibility

• EGL crash guard — automatically falls back to software rendering on virtual machines (Hyper-V, KVM, VirtualBox) and systems without GPU acceleration, instead of crashing on startup

Installer Branding (Windows)

• Custom branded graphics on WiX (MSI) and NSIS setup screens

Auto-Update

If you have v0.5.0-beta.1 installed with the beta channel selected, you should be prompted to update automatically.

Downloads

Grab the installer for your platform from the assets below.

immichBEAM v0.5.0-beta.1

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/features on 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 $HOME writes
• validate_folder_path() and validate_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 AssetBrowser component 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
• useStatus throttled 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 ServerFeatures serde: rename → alias so 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

Beta Channel

Latest beta: v0.5.0-beta.1

immichBEAM v0.4.1

What's Changed

UI & Branding

• Sidebar now uses the circular app icon with immich/BEAM text branding
• Activity section moved above Library in sidebar navigation for a more logical flow
• Favicon updated to the circular app icon

Build & CI

• Release workflow now builds for Ubuntu 24.04 & 26.04 (x64 + ARM), macOS (universal), Windows (x64 + ARM)
• Dropped Ubuntu 22.04 — Tauri 2 requires WebKit2GTK 4.1 (available from Ubuntu 23.10+)
• Windows ARM builds added as experimental

Project

• Horizontal logo added for README header
• Updated README with new description and feature overview
• Added WTFPL license
• Added roadmap section to README

Downloads

Platform	File
macOS (Universal)	immichBEAM_0.4.1_universal.dmg
Windows x64	immichBEAM_0.4.1_x64-setup.exe or .msi
Windows ARM	immichBEAM_0.4.1_arm64-setup.exe or .msi
Linux x64 (Debian/Ubuntu)	immichBEAM_0.4.1_amd64.deb
Linux ARM (Debian/Ubuntu)	immichBEAM_0.4.1_arm64.deb
Linux x64 (Fedora/RHEL)	immichBEAM-0.4.1-1.x86_64.rpm
Linux ARM (Fedora/RHEL)	immichBEAM-0.4.1-1.aarch64.rpm
Linux x64 (AppImage)	immichBEAM_0.4.1_amd64.AppImage
Linux ARM (AppImage)	immichBEAM_0.4.1_aarch64.AppImage

Full Changelog: https://github.com/nickdwhite/immichBEAM/blob/main/CHANGELOG.md