Skip to content

bjoernch/immich-companion

Repository files navigation

Immich Companion — your photo library follows you around the web

A community browser extension for self-hosted Immich.
Save anything you see on the web, smart-search your library from the toolbar popup, and turn every new tab into a memory. Also featured in the official Awesome Immich Collection

Click your browser to install. Chromium-based browsers (Chrome, Edge, Brave, Opera, plus Vivaldi, Arc, …) install from the Chrome Web Store. Firefox installs from Mozilla Add-ons. Safari installs as a self-built Xcode project — see SAFARI.md.

Chrome
Chrome
Edge
Edge
Brave
Brave
Opera
Opera
Firefox
Firefox
Safari
Safari

Features

Save the web to your library

Right-click any image or video on any website to upload it directly to your Immich server. Optionally adds every saved item to a default album.

Save & share

One click uploads the asset, creates a public Immich share link, and copies it to your clipboard — ready to paste anywhere.

Smart search, everywhere

  • Toolbar popup — phone-gallery-style timeline grouped by month, with sticky date headers and a year scrubber on the right edge. Same view for both your most recent items and search results, with quick actions on every photo (copy to clipboard, share link, download original, open in maps).
  • Google search results — when you Google something, photos in your library that match the query appear in a card at the top of the results. The search runs entirely between your browser and your Immich; nothing is sent to Google.

New tab as a memory feed

A random photo from your library greets you on every new tab, with an "On this day" strip showing memories from past years. Optional EXIF detail row underneath the date — camera, lens, ISO, aperture, shutter, focal length, dimensions. Pick a specific album as the source, choose an auto-rotate interval, or turn it off entirely.

Polished little things

Dark and light themes (with system-match), keyboard shortcut (Ctrl+Shift+L / ⌘+Shift+L), connection-status badge on the toolbar icon, in-page upload toasts, share-album toolbar (Slideshow + Download-all) on your Immich /share/... URLs, drag-and-drop file uploads, automatic duplicate detection.


Customising the new tab (or getting out of it)

The "New tab as a memory feed" feature is opt-in for fresh installs (the welcome page asks). Once enabled, it owns every new tab — every browser extension that overrides the new tab works this way; there is no API for an extension to release the override at runtime. Closest you can get without uninstalling:

  • Calmer photo background. Pick a Source for new tab photos in Settings → New Tab that's an album of neutral wallpapers/landscapes (Immich → create an album → throw a few non-personal photos in it → select it from the dropdown).
  • Hide the memory strip. Settings → New Tab → toggle off "On this day" memory strip.
  • Hide the EXIF row. Same screen → toggle off Show photo details.
  • No photo at all, just a clock. Settings → New Tab → toggle Replace new tab page off. The tab now shows an explainer card with one-click options to redirect every new tab to a URL of your choice (Google, your own homepage, anywhere).
  • Real browser default new tab. Remove the extension at chrome://extensions / about:addons. There is no in-extension way to fully restore the browser's own new tab.

Privacy

The extension transmits data only to the Immich server you configure. No analytics, no third-party services, no tracking. Your API key stays in chrome.storage.local on your device.

Full privacy policy


Install

  • Chrome Web Store — also covers Edge, Brave, Vivaldi, Arc, Opera and other Chromium-based browsers.
  • Firefox Add-ons — Firefox 121 or newer.
  • Safari (macOS) — experimental, self-built. See SAFARI.md for the Xcode steps.

After install

The welcome tab opens automatically. You'll need:

  • A self-hosted Immich instance you can sign into.
  • An API key from your Immich account — Account Settings → API Keys. The welcome page lists the exact required scopes.

The keyboard shortcut Ctrl+Shift+L (⌘+Shift+L on macOS) opens the popup.


License

MIT. Unofficial community extension. Not affiliated with the Immich project.

About

Browser extension for self-hosted Immich: save, search, share.

Resources

License

Security policy

Stars

115 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors