Highlights
Favorites filter for the new-tab background (closes #10)
Settings → New Tab → Source for new tab photos gains an "Only show favorites" toggle. When on, the new-tab photo, the precache top-up, and the "On this day" memory strip all restrict to assets you've marked as favorites in Immich.
- Combines with the album selector — if you also pick an album, the result is "favorites within that album," not the entire album. The settings page renders a small clarifier under the toggle when both are set.
- Server-side filter via
isFavorite: trueon/search/randomand/search/metadata— much cheaper than fetching everything and filtering client-side, and supported across Immich versions (older servers simply ignore the field). - Uses the existing
asset.readscope; no API key change required for the typical setup. If the key happens to lack the scope, the settings page surfaces the exact error inline. - If you have no favorites yet (or the selected album contains none), the toggle area explains what to do instead of silently rendering nothing.
- Toggling either album or favorites-only now wipes the SW precache queue, so the next new tab immediately reflects the new criteria instead of cycling through 1–3 stale entries.
Pagination always renders a fixed 6-page window
The popup's pagination bar used to grow as you paged forward — 3 numbers on page 1, 4 on page 2, 5 from page 3 onward — which looked broken between transitions. It now always renders 6 page numbers, anchored to the start when you're near page 1 and to the end when you're on the last known page. The window only shows fewer numbers when the result set genuinely has fewer than 6 pages.
Toolbar icon at 16 px restored
The three-card stack used at 48 / 128 px doesn't survive the supersample-then-resize to 16 px: the rotated semi-transparent back/middle cards downsampled into the gradient and the photo silhouette disappeared, leaving the toolbar icon looking like a plain purple chip. The 16 px icon now uses a dedicated render — single white card scaled to ~72 % × 56 % of the canvas, slight tilt, the same sun + mountains landscape inside — so it reads as a photo at toolbar resolution.
Closed issues
- #10 — Allow Favorites to be used as background for new tab. Closed by the new "Only show favorites" toggle in Settings → New Tab.
Compatibility
- Existing settings persist across the update — server URL, API key, default album, theme, all feature toggles, the saved-uploads list.
chrome.storage.localsurvives the in-place update from every store. - The new
newtabFavoritesOnlydefault isfalse, so the new tab keeps behaving exactly as before for everyone who doesn't flip the toggle. - Verified untouched in this release: the save-to-Immich flow, content script, popup search / video preview / filter pills / Maps / update banner / bug-report consent flow, Safari workflow, manifest permissions. Only the pagination renderer in
popup.jschanged; everything else around it is byte-equal to v0.8.0.
Install
- Chrome Web Store — auto-updates within ~1–2 days. Also covers Edge, Brave, Vivaldi, Arc, Opera and other Chromium browsers.
- Firefox Add-ons — auto-updates within ~1 day.
- Safari (macOS, experimental) —
immich-companion-safari-0.8.1.zipbelow; follow SAFARI.md for the Xcode build steps.
Full Changelog: v0.8.0...v0.8.1