pastilhas 2fb2f89ba6 say what this plugin is for, in the store's words
tags are how the marketplace is browsed rather than scrolled: a list of them on
the left, the plugins that carry one on the right. a closed vocabulary
(PLUGIN_TAGS in the platform) because free text becomes homelab, home-lab, Home
Lab and selfhosted inside a month, and a filter list of synonyms is worse than
no filter at all.

declared here rather than curated in the catalogue, so a plugin can say what it
is and nobody edits a table when one ships. the marketplace caches it on sync,
exactly as it already does for label and summary.
2026-08-27 06:50:11 +00:00
2026-08-19 06:50:56 +01:00

Photos

Your Immich library, reached through Officer.

Photos does not store photographs and does not install Immich. You point it at an instance you already run; it forwards to it and holds the API key server-side, so no device ever carries one. Your library, your originals and every thumbnail stay exactly where they are.

What you get

  • The whole library — timeline, albums, people, places, sharing and search, as panels inside Officer.
  • A map of everything with coordinates, clustered.
  • Upload from the phone, through Officer rather than to Immich directly.
  • More than one instance. Accounts are a per-user registry with a label, a URL and a key; one is active and you switch between them in the app.

What you need

An Immich you already run, and an API key from it (Immich → Account Settings → API Keys).

Create the key with all permissions. A scoped key returns 403 per route, which does not read as a permissions problem — it reads as a broken feature, one screen at a time.

Nothing else. No system packages, no host binaries.

Setup

  1. Install the plugin.
  2. Open /photos → Connection and add an instance: a label, its URL, and the API key.
  3. It probes the server, records its version, and marks the account active.

What it deliberately does not do yet

  • It is a client, not a backup. Nothing is copied to Officer. If your Immich goes away, so does the library — this plugin never held it.
  • The key is write-only across the boundary. The account list reports label, URL and which is active, and has no field that could carry a key, masked or otherwise. The only way to change one is to replace it. That is deliberate, and it means the app cannot show you a key you have forgotten.
  • Editing lives in Immich. This browses, searches, uploads and organises into albums; it is not a photo editor and will not become one.
S
Description
Photos — your Immich library, reached through Officer
Readme
2.2 MiB
Languages
TypeScript 100%