Immich 3.2.0

Original release notes

v3.2.0

Welcome to Immich v3.2.0!

This release includes many new features as well as the usual collection of bug fixes and cleanups. Keep reading below for a list of highlights.

Highlights

Docker compose builder
Revamped search UI (web)
Search API v2 (server)
View own people in shared assets, cross-user clustering
Workflow tags trigger and actions
Dedicated memories page
Tag renaming (web)
View assets in map viewport (web)

Docker compose builder

We recently released our new docker compose builder, which lets you put together a custom compose file for Immich more easily. Please try it out and give us your feedback!

Search API v2 (server)

We have built an entirely new search API that, amongst other things, will support searching within albums and combining multiple search filters with both AND and OR operations. Some of these features will be exposed to the search UI interfaces in the future, others will be used to power other fancy features as well as give 3rd party tools more functionality. If you are interested in the particular changes and examples for how to use the new API, feel free to check out the PR as well as our API documentation at .

Revamped search UI (web)

We have a new designer who helped us remodel the search modal, which has been pretty complex before and looks a lot more visually appealing in our opinion now. It still supports the same functionality, but with some quality of life additions as well as a significantly simpler look. In the future, we will extend this to also include some of the new features enabled by the new search API. Stay tuned and give us your feedback on the new design!

New search modal filtering by images with Jason in it, taken in the last 30 days in BC, Canada, tagged "Long Beach" with the context search term "Swimming"

Advanced filters showing camera make, model, and lens model, as well as filers for favorite and archive status, and album membership

View own people in shared assets

We are very happy to ship the first step towards better sharing. You can now have people recognized across trusted users, which also allows you to view people you already have records of in any shared assets!

In the user sharing settings there is a new section; cluster group.

The user sharing settings showing a cluster group with Jane Doe and Mich in it

You can invite users on your instance that you trust to your own group, or join another group you have been invited to. These cluster groups make it possible to identify people in assets shared by users in the same group. They also likely improve accuracy, as the clustering will operate on a bigger pool of faces. People names and birth dates are still set on a per-user level and aren't (yet) shared with users in the same group.

As of now, this requires resetting facial recognition for all users in the group, in order for the changes to apply retroactively for all assets. This means, names and birth dates will be lost, and the results can vary slightly compared to before. Only faces recognized by machine learning will be affected by this. We may be able to do some non-destructive merging in the future, but for now this is a necessary step in order to fully benefit from the feature. That is why we put a button in the sharing settings for every user in the group (specifically also non-admins) to reset the facial recognition for that group.

Workflow tags trigger and actions

Workflows have gotten a new trigger. You can now do automations when an asset has been tagged.

In order to use this new trigger, there is also a new filter that allows you to match specific tags. It supports matching for all, any, or none in the provided list.

Lastly, a new workflow action to add tags to the current asset has also been added. It allows to add a list of tags at once.

Dedicated memories page

The new memories page allows you to view past memories. You can also favorite memories and they will show up here and never get deleted. The goal is for this to be a place you can come back to at any point and reminisce in old memories.

Tag renaming (web)

Finally, you can also rename existing tags. This is a small addition to the edit tag modal on web, but under the hood was more complicated than you might expect.

View assets in map viewport (web)

Similarly to showing a timeline all assets in a cluster on the map when clicking on it, you can now open a timeline for assets currently in the viewport. There is a new button among the map controls to show assets in the area. It will open a timeline that will update as you pan around the map.

The map page showing a timeline of assets currently in the viewport on the right

As always, please consider supporting the project.

Cheers!

Support Immich

If you find the project helpful, you can support Immich by purchasing a product key at or our merchandise at

----

What's Changed

Features

feat: workflow logging by @benbeckford in https://github.com/immich-app/immich/pull/29878
feat(web): new search ui by @benbeckford in https://github.com/immich-app/immich/pull/30279
feat: new config endpoints by @jrasm91 in https://github.com/immich-app/immich/pull/30881
feat: cluster groups by @jrasm91 in https://github.com/immich-app/immich/pull/30739
feat: asset file apis by @jrasm91 in https://github.com/immich-app/immich/pull/25900
feat: memories view by @benbeckford in https://github.com/immich-app/immich/pull/28675
feat(mobile): show asset owner in asset details by @Lauritz-Tieste in https://github.com/immich-app/immich/pull/29302
feat(server): new search API by @timonrieger in https://github.com/immich-app/immich/pull/30179

Enhancements

feat: store null instead of empty string for album.description by @gPinato in https://github.com/immich-app/immich/pull/30123
feat: log hint about downgrades when migration is missing by @bo0tzz in https://github.com/immich-app/immich/pull/30493
feat(web): search album description in add-to-album modal by @djadji-gueye in https://github.com/immich-app/immich/pull/30462
feat: Display the number of selected items in AlbumPickerModal title by @statox in https://github.com/immich-app/immich/pull/30485
feat(widget): add toggle to match icon theme by @bwees in https://github.com/immich-app/immich/pull/30428
feat: workflow asset tag trigger/filter/action by @benbeckford in https://github.com/immich-app/immich/pull/29043
feat: iOS dynamic background ids by @mikes1991gh in https://github.com/immich-app/immich/pull/30574
feat: actions undo handling by @shenlong-tanwen in https://github.com/immich-app/immich/pull/30481
feat: rotate an API key by @bwees in https://github.com/immich-app/immich/pull/30801
fix(cli): enforce node engine version on start by @bo0tzz in https://github.com/immich-app/immich/pull/30437
chore(server): migrate library e2e tests by @etnoy in https://github.com/immich-app/immich/pull/27277
feat: add oauth account management url by @sacha-c in https://github.com/immich-app/immich/pull/30873
feat(web): tag renaming v2 by @jorbrock in https://github.com/immich-app/immich/pull/27909
chore: search filter animation improvement and reactive search cue example by @alextran1502 in https://github.com/immich-app/immich/pull/30866
perf(web): use hash-wasm SHA-1 with pure-JS fallback for upload hashing by @mosh-dev in https://github.com/immich-app/immich/pull/30107
fix: don't swallow fetch errors by @bo0tzz in https://github.com/immich-app/immich/pull/30496
feat(mobile): map asset number by @YarosMallorca in https://github.com/immich-app/immich/pull/28911
feat: allow users to re-run facial recognition for their group by @danieldietzler in https://github.com/immich-app/immich/pull/30965
feat(web): view assets in map viewport by @rickytrevor in https://github.com/immich-app/immich/pull/27492

Bug fixes

fix: make sure iOS memory widget render by @alextran1502 in https://github.com/immich-app/immich/pull/30172
fix: calendar heatmap permissions by @danieldietzler in https://github.com/immich-app/immich/pull/30310
fix: calendar heatmap api key permissions by @danieldietzler in https://github.com/immich-app/immich/pull/30314
fix(deployment): matplotlib in rootless deployments by @mmomjian in https://github.com/immich-app/immich/pull/30328
fix(mobile): refresh person thumbnail when the featured photo changes by @santoshakil in https://github.com/immich-app/immich/pull/29350
fix: assetFileFilter path matching by @benbeckford in https://github.com/immich-app/immich/pull/30394
fix: shared check for server setup availability by @bo0tzz in https://github.com/immich-app/immich/pull/30311
fix(mobile): resolve owned assets when partner owns identical asset by @agg23 in https://github.com/immich-app/immich/pull/30137
fix(web): Fix face thumbnail when swapping merge direction by @lhvy in https://github.com/immich-app/immich/pull/30466
fix(server): reject invalid or deleted user when creating a partner by @djadji-gueye in https://github.com/immich-app/immich/pull/30431
fix(server): remove the asset row when an upload fails after creating it by @santoshakil in https://github.com/immich-app/immich/pull/30349
fix(mobile): correct mislabeled Bengali locale entry by @DrHaque in https://github.com/immich-app/immich/pull/30519
fix(mobile): sync stack changes from the websocket by @santoshakil in https://github.com/immich-app/immich/pull/30479
fix: metadata extraction as LensModel can be a float by @danieldietzler in https://github.com/immich-app/immich/pull/30512
fix(mobile): run one more sync round when a request arrives mid sync by @santoshakil in https://github.com/immich-app/immich/pull/30478
fix: use setRequireOriginal on SDK 29 and above by @shenlong-tanwen in https://github.com/immich-app/immich/pull/29072
fix(mobile): stale local renders after editing a photo on device by @santoshakil in https://github.com/immich-app/immich/pull/30415
fix(mobile): stop websocket reconnect loop draining battery when server is unreachable by @santoshakil in https://github.com/immich-app/immich/pull/29901
fix(mobile): stop long images squishing on ios by @santoshakil in https://github.com/immich-app/immich/pull/29367
fix(mobile): keep backup remainder from going negative by @santoshakil in https://github.com/immich-app/immich/pull/29011
fix(mobile): handle asset websocket events by @santoshakil in https://github.com/immich-app/immich/pull/30499
fix(mobile): stop disabling androidx.startup initializers by @shenlong-tanwen in https://github.com/immich-app/immich/pull/30559
fix: map not updating after viewing an asset by @shenlong-tanwen in https://github.com/immich-app/immich/pull/30601
fix(deployment): Add huggingface cache directory to Dockerfile by @mmomjian in https://github.com/immich-app/immich/pull/30357
fix(mobile): video playback controls dead for backed up videos opened from search by @santoshakil in https://github.com/immich-app/immich/pull/30587
fix(mobile): decode remote thumbnails at displayed size by @santoshakil in https://github.com/immich-app/immich/pull/29965
fix(mobile): don't let a frozen sync block syncing on resume by @santoshakil in https://github.com/immich-app/immich/pull/29870
fix: face label clipping by @danieldietzler in https://github.com/immich-app/immich/pull/30712
fix: owner cascade delete album by @danieldietzler in https://github.com/immich-app/immich/pull/30692
fix(mobile): prevent iOS status bar scroll to top during transitions by @agg23 in https://github.com/immich-app/immich/pull/30717
fix(mobile): disable iOS smart quotes/dashes in email/password inputs by @agg23 in https://github.com/immich-app/immich/pull/30767
fix(mobile): prevent snapping to center on pinch-to-zoom release (#29207) by @cmdPromptCritical in https://github.com/immich-app/immich/pull/29343
fix: shared link create validation by @danieldietzler in https://github.com/immich-app/immich/pull/30762
fix(mobile): mark finished downloads complete instead of leaving them stuck by @santoshakil in https://github.com/immich-app/immich/pull/29023
fix: freeze on navigating back album description by @YarosMallorca in https://github.com/immich-app/immich/pull/30781
fix(server): guard createAll against empty values list by @tech00exploere in https://github.com/immich-app/immich/pull/30837
fix(server): respect backpressure in the sync stream by @enol5423 in https://github.com/immich-app/immich/pull/30764
fix(server): update ocr & faces after asset edit by @YarosMallorca in https://github.com/immich-app/immich/pull/29303
fix(mobile): resend an upload once when the connection dies before a response by @santoshakil in https://github.com/immich-app/immich/pull/30843
fix(mobile): cannot deep link to memory lane (#30634) by @nikhilpodila in https://github.com/immich-app/immich/pull/30787
fix: redis cli ping command by @mmomjian in https://github.com/immich-app/immich/pull/30329
fix(server): do not throw on unparsable DB_URL when building backup arguments by @NoiceHax in https://github.com/immich-app/immich/pull/30759
fix(server): Sort stacked assets by creation date by @timonrieger in https://github.com/immich-app/immich/pull/24033
fix(web): gracefully handle map errors when WebGL is disabled by @meesfrensel in https://github.com/immich-app/immich/pull/26538
fix(server): unicode email validation by @YarosMallorca in https://github.com/immich-app/immich/pull/30871
fix(mobile): order album/place/person timelines by local date by @santoshakil in https://github.com/immich-app/immich/pull/29338
chore(mobile): update flutter-maplibre-gl to 0.27.0 by @agg23 in https://github.com/immich-app/immich/pull/30892
fix(web): download archives via html POST forms by @diogotcorreia in https://github.com/immich-app/immich/pull/30021