Breaking changes ⚠️

• Older Immich database (Before the September 6th, 2022 release) might run into an issue with the checksum column being null in the assets table. Please follow this guide to fix.
• The server and the mobile app must be on the same version (v1.58.0) for the Partner sharing feature on the mobile app to work correctly.
• The docker-compose.yml has changed the content. Please make sure to update yours.

Highlights

Hello everyone, I am happy to announce the 102nd release of Immich, which includes the following highlights:

• Map filtering
• You can now view your Partner’s assets on the mobile app and also manage your Partner’s accessibility to your timeline on the mobile app.
• Immich’s server can now understand XMP Sidecars files.
• We added support for client-side hashing in preparation for the improved upload process across the clients.
• We improved the stability of the server when handling a large amount of new incoming assets by managing the queues better.

Map's filters

You can now use the option button on the map page to filter the display cluster by date-time

Partner sharing on mobile

You can now access your partners’ timelines and manage your shared partners directly on the mobile app, thanks to the work of @fyfrey. The Share with partner is no longer grayed out (woohoo).

Support XMP Sidecar files

Thank @alex-phillips and @jrasm91 contribution to this feature. Immich can now ingest XMP sidecars on file upload (via the CLI) as well as detect new sidecars that are placed in the filesystem for existing images.

XMP sidecars are external XML files that contain metadata related to media files. Many applications read and write these files exclusively or in addition to the metadata written to image files. They can be a powerful tool for editing and storing metadata of a media file without modifying the media file itself. When Immich receives or detects an XMP sidecar for a media file, it will attempt to extract the metadata from both the sidecar and the media file. It will prioritize the metadata for fields in the sidecar but will fall back and use the metadata in the media file if necessary.

When importing files via the CLI bulk uploader, Immich will automatically detect XMP sidecar files that exist next to the original media file and have the exact same name with an additional .xmp file extension (i.e., PXL_20230401_203352928.MP.jpg and PXL_20230401_203352928.MP.jpg.xmp).

Two administrator jobs are associated with sidecar files: SYNC and DISCOVER. The sync job will re-scan all media with existing sidecar files and queue them for a metadata refresh. This is a great use case when third-party applications are used to modify the metadata of media. The discover job will attempt to scan the filesystem for new sidecar files for all media that does not currently have a sidecar file associated with it.

Please make sure you are using the latest CLI version to be able to upload the XMP file to the server.

Note: When using external software to manage sidecar metadata, please keep in mind that Immich will not detect changes in the main image file. Please make sure to run the SYNC job to get the data updated

Support for client-side hashing

With the contribution of @etnoy, the server now has a mechanism that checks for client-side hashing, which will improve the upload process on the CLI and the mobile app in the upcoming releases.

Improve queuing system

In one sitting, @jrasm91 single-handedly bent the server to his will; the queuing system now obeys his commands to run the background job orderly without bogging down the CPU. This improvement helps with the server's stability, solves request timeout issues to the database connection, and resolves missing thumbnail situations due to stale data.

There are many additional changes to improve the application as a whole. Please check out the detailed changelog below.

As always, please consider supporting the project.

🎉 Cheer! 🎉

Support

If you find the project helpful and it helps you in some ways, you can support the project one time or monthly from GitHub Sponsors

It is a great way to let me know that you want me to continue developing and working on this project for years to come.

What's Changed

Mobile

• feat(mobile): partner sharing by @fyfrey in #2541
• chore(mobile): update isar by @fyfrey in #2571

Web

• feat(web): job tile icons by @jrasm91 in #2546
• feat(web): use user layout on admin pages by @jrasm91 in #2550
• feat(web): show assets without thumbs by @jrasm91 in #2561
• feat(web+server): map date filters + small changes by @michelheusschen in #2565
• fix(web): back button on person page by @michelheusschen in #2566
• feat(web): improved action bar actions by @jrasm91 in #2553
• fix(web): small style issues by @michelheusschen in #2578
• fix(web): hide album context menu by @jrasm91 in #2543

Server

• refactor(server): use cascades for keys and tokens by @jrasm91 in #2544
• fix(server): reverse geocoding delete dump logic by @jrasm91 in #2551
• refactor(server): album controller by @jrasm91 in #2539
• feat(server): Add support for client-side hashing by @etnoy in #2072
• feat(server): xmp sidecar metadata by @alex-phillips in #2466
• refactor(server): create album by @jrasm91 in #2555
• refactor(server): update album by @jrasm91 in #2562
• refactor(server): bull jobs by @jrasm91 in #2569
• refactor(server): delete album by @jrasm91 in #2570
• refactor(server): job handlers by @jrasm91 in #2572
• feat(server): disk stats for library folder by @jrasm91 in #2560
• fix(server): invalid exif date string by @jrasm91 in #2580
• fix(server): exif time extraction by @michelheusschen in #2583
• fix(server): missing metadata extraction job by @alextran1502 in #2586

Other

• docker: use default entry point and command where applicable by @uhthomas in #2529

New Contributors

• @alex-phillips made their first contribution in #2466

Full Changelog: v1.57.1...v1.58.0