Immich and PhotoPrism
Connect Immich or PhotoPrism to the Photos widget with a read-only key.
The Photos widget shows pictures from your Immich or PhotoPrism library as a slideshow, a grid, a mosaic of mixed sizes or a sideways strip. A click opens the photo large, with its date and place; arrows and the keyboard move through the selection.
Connect a library
-
Open Settings → Integrations → Photo libraries.
-
Choose Immich or PhotoPrism and give the connection a name.
-
Enter the library address (for example
https://photos.example.com). -
Immich: in Immich, open Account settings → API keys → New API key, untick All permissions and tick only:
Permission Used for asset.readFinding photos (random, recent, favorites, on this day) asset.viewThumbnails and previews album.readListing albums and reading the chosen one memory.readImmich memories, for “On this day” Leave out a permission whose mode you do not use. No
create,update,delete,uploadordownloadpermission is needed: NasDash only reads, and never fetches originals. The key sees the library of the account that created it (and albums shared with it), so a dedicated account narrows what can appear. -
PhotoPrism: create an app password (PhotoPrism → Settings → Account → Apps and devices) and paste it.
-
Enable Accept a self-signed certificate only for a server you own that uses one, save, then test the connection.
Settings
| Setting | Choices |
|---|---|
| Photos shown | Random, recent, favorites, an album, on this day |
| Photos in the selection | 4 to 60 |
| Display | Slideshow, grid, mosaic, strip |
| Photos at once | Grid and mosaic |
| Change by itself | On: the next photos come at the chosen pace (10 s to 5 min), paused under the pointer. Off: arrows move through the selection. Always on for random photos, which also get a new selection every hour. |
| Date and place | Caption of the slideshow |
Privacy
Photos pass through the NasDash server: the library address and key never reach the browser, and a photo is served only through the widget that listed it. The link to open a photo in the library is shown to administrators only. Viewers see the widget only with the Photos permission (Settings → Users and access). The public demo shows generated landscapes.