v1.116.0

[alextran1502]

v1.116.0

Highlights

Welcome to release v1.116.0 of Immich!

This release continues to focus on bug fixes, which is quite typical for us, especially after large releases. Highlights for this release include:

• Improved.immich file boot checks
• Improved external library scanning
• Timezone improvements
• Tag clean up job
• Better person merge workflow
• Improve settings pages (web)
• Fixed possible startup failure due to .immich files
• Serve style.json directly from tiles.immich.app
• New "random" api for 3rd party apps
• Notable fix: Uncaught error causes the hashing process to abort entirely in the mobile app

Issues with .immich files on boot in 1.115.0

There were a small number of users who experienced problems with booting Immich after upgrading to 1.115.0. This was due to the new .immich file checks that verify your library folders are still mounted and writable. If, and only if you had problems booting 1.115.0 that persist into 1.116.0 with an error of "Unable to write .immich file, already exists", you can fix this by stopping Immich and removing the .immich files in the UPLOAD_LOCATION subfolders (upload, library, thumbnails, etc). If you experience any further problems, please do contact us on discord or via a github discussion.

Improved external library scanning

The external library scan mechanism has been reduced from four seperate options, to one. There is now a single button "Scan" that will handle all cases. Files that are offline (deleted or missing) now get hidden from the timeline and will show in the trash folder. This will become a dedicated screen in a future release. If the file comes back online, then the assets will re-appear in the main timeline and albums they were in previously. If the asset is offline for longer than the trash duration set in the admin config, the assets will be removed from immich automatically

Timezone improvements

Previously, if the timezone of an asset was unknown, it would apply an arbitrary offset by assuming the time was UTC and adjusting it to the viewer's timezone. Now, a timezone will only be shown if it is known for the asset.

Before	After

Tag cleanup job

If you have tags with no assets in them, you can remove them by running the "Tag clean up" job
here.

Better person merge workflow

The merge page always uses the same direction to merge people together. The "source" gets merged into the "target". However, sometimes the target is an unnamed person. Now, in these situations, the merge direction is automatically reversed, leading to a better user experience.

Serve style.json directly from tiles.immich.app

Up to this release, the immich server served the style.json file. That file includes the styling of the map as well as the font/glyphs/tiles provider. However, this also means that tile server updates were always bound to immich server updates. With this change, we decouple the two by serving the (static)style.json file from the infrastructure we serve the map tiles. This is also in line with pretty much any other map/tile provider. This change will assist us in bringing map improvements to all users in the future, such as map localisation without having to manage multiple different immich versions.
However, note that this does not affect the ability to specify a different style.json URL in the admin settings.

UI improvement for settings pages

Each setting now has a new design accordion section with a distinguishable icon to help identify it easier as the options get longer. You can also search for the administration settings by their title and subtitle in your native language.

New "random" API

We are deprecating GET /assets/random in favor of POST /search/random, which works very similar to the other search endpoints. It includes more relations and filters. In the future, we plan to add an option to search and filter by a specific album ID.

Support Immich

If you find the project helpful, you can support Immich by purchasing a product key at https://buy.immich.app.

Cheers! 🍻

What's Changed

🌟 Enhancements

• fix(web): better merge direction by @jrasm91 in fix(web): better merge direction #12601
• fix(server): include partner assets in random endpoint by @jrasm91 in fix(server): include partner assets in random endpoint #12599
• feat: tag cleanup job by @jrasm91 in feat: tag cleanup job #12654
• feat(web): improve UI/UX for settings pages by @alextran1502 in feat(web): improve UI/UX for settings pages #12626
• feat(server): sort assets randomly from the API 'api/search/metadata' endpoint by including 'order': 'rand' in the API call. by @jschwalbe in feat(server): sort assets randomly from the API 'api/search/metadata' endpoint by including 'order': 'rand' in the API call. #12741
• feat: serve map tile styles from tiles.immich.cloud by @zackpollard in feat: serve map tile styles from tiles.immich.cloud #12858
• feat(web): fixed combobox positioning by @ben-basten in feat(web): fixed combobox positioning #12848
• refactor(server): library syncing by @etnoy in refactor(server): library syncing #12220

🐛 Bug fixes

• fix(web): load original panorama if specified in user settings by @Saschl in fix(web): load original panorama if specified in user settings #12123
• fix(web): bucket by localDateTime by @jrasm91 in fix(web): bucket by localDateTime #12612
• fix(web): memory viewer by @jrasm91 in fix(web): memory viewer #12649
• fix(server): increase person search limit by @jrasm91 in fix(server): increase person search limit #12619
• fix(web): scrollbar shows when not need by @alextran1502 in fix(web): scrollbar shows when not need #12659
• fix(server): fix modify date extraction by @alextran1502 in fix(server): fix modify date extraction #12658
• fix: empty and restore over 1,000 items by @jrasm91 in fix: empty and restore over 1,000 items #12751
• fix(web): upgrade old style theme preference by @jrasm91 in fix(web): upgrade old style theme preference #12775
• fix(web): asset grid with invalid asset id (at) by @jrasm91 in fix(web): asset grid with invalid asset id (at) #12772
• fix: creating tags with leading/traling slashes by @danieldietzler in fix: creating tags with leading/traling slashes #12778
• fix(web): only show the timezone when it is known by @jrasm91 in fix(web): only show the timezone when it is known #12779
• fix(mobile): Issue Selecting Many Albuns for Backup by @sshubhm in fix(mobile): Issue Selecting Many Albuns for Backup #12784
• fix: rework file handling so we always explicitly create, overwrite or both by @zackpollard in fix: rework file handling so we always explicitly create, overwrite or both #12812
• fix(mobile): fix uncaught error in getting file cause hashing procses to be aborted entirely by @alextran1502 in fix(mobile): fix uncaught error in getting file cause hashing procses to be aborted entirely #12826
• feat(server): validate rating by @dreadster3 in feat(server): validate rating #12855
• fix(web): Fix same key for delete and stack actions by @Caesiumhydroxid in fix(web): Fix same key for delete and stack actions #12865
• fix: normalize external domain by @danieldietzler in fix: normalize external domain #12831
• fix(server): gracefully handle unknown jobs by @jrasm91 in fix(server): gracefully handle unknown jobs #12870
• fix: show asset count for unassigned faces by @danieldietzler in fix: show asset count for unassigned faces #12871
• fix: remove no longer needed LD_LIBRARY_PATH by @jrasm91 in fix: remove no longer needed LD_LIBRARY_PATH #12872
• fix: set min values for face detection to reasonable values by @danieldietzler in fix: set min values for face detection to reasonable values #12877
• fix: album title state weirdness by @danieldietzler in fix: album title state weirdness #12874
• fix: do not use trashed assets as album covers by @jrasm91 in fix: do not use trashed assets as album covers #12905
• fix(server): http error parsing on endpoints without a default response by @jrasm91 in fix(server): http error parsing on endpoints without a default response #12927
• fix(web): delete non-empty album by @jrasm91 in fix(web): delete non-empty album #12937

📚 Documentation

• docs: scaling immich guide by @bo0tzz in docs: scaling immich guide #12593
• docs: add hint for healthcheck.start_interval by @kastl-ars in docs: add hint for healthcheck.start_interval #12643
• docs: mobile architecture diagram by @fyfrey in docs: mobile architecture diagram #12841
• docs: add section for Traefik Reverse Proxy by @zp33dy in docs: add section for Traefik Reverse Proxy #12813
• fix(docs): typo in remote-access.md by @JonOcto in fix(docs): typo in remote-access.md #12895
• docs: details for windows users how to change docker volume by @mmomjian in docs: details for windows users how to change docker volume #12551
• docs: hidden files cursed knowledge by @jrasm91 in docs: hidden files cursed knowledge #12929

🌐 Translations

• fix(mobile): fix mn-MN.json file name by @aryiu in fix(mobile): fix mn-MN.json file name  #12558
• chore(web): update translations by @weblate in chore(web): update translations #12590
• chore(web): update translations by @weblate in chore(web): update translations #12737

New Contributors

• @kastl-ars made their first contribution in docs: add hint for healthcheck.start_interval #12643
• @sshubhm made their first contribution in fix(mobile): Issue Selecting Many Albuns for Backup #12784
• @zp33dy made their first contribution in docs: add section for Traefik Reverse Proxy #12813
• @dreadster3 made their first contribution in feat(server): validate rating #12855
• @Caesiumhydroxid made their first contribution in fix(web): Fix same key for delete and stack actions #12865
• @jschwalbe made their first contribution in feat(server): sort assets randomly from the API 'api/search/metadata' endpoint by including 'order': 'rand' in the API call. #12741
• @JonOcto made their first contribution in fix(docs): typo in remote-access.md #12895
• @carykees98 made their first contribution in fix(web): Updated web README.md #12899

Full Changelog: https://github.com/immich-app/immich/compare/v1.115.0...

---

This discussion was created from the release v1.116.0.

[samluxh]

Big thank you for your effort ❤️

Please add a option to be able to search for pictures of a specific year or month without the full date. Example: August 2022 or August (all years) or just 2022 (all months and days).

[SitramSoft]

That feature would be awesome

[ThatCoffeeGuy]

immich_server | [Nest] 17 - 09/26/2024, 8:15:43 PM LOG [Api:StorageService] Verifying system mount folder checks (enabled=true) immich_server | [Nest] 17 - 09/26/2024, 8:15:43 PM ERROR [Api:StorageService] Failed to read upload/encoded-video/.immich: Error: ENOENT: no such file or directory, open 'upload/encoded-video/.immich' immich_server | [Nest] 17 - 09/26/2024, 8:15:43 PM ERROR [Api:StorageService] The "encoded-video" folder appears to be offline/missing, please make sure the volume is mounted with the correct permissions immich_server | api worker exited with code 1

docker-compose relevant part:

/mnt/SSD1TBVIRT/IMMICH_ENCODED_VIDEO:/usr/src/app/upload/encoded-video/

Same issue. immich has all read write access, can touch as user and as root to the folder, I'm clueless. Everything else works.

[jrasm91]

The problem is there should be an .immich file there and there isn't one

[ThatCoffeeGuy]

Resolved, it seems I missed copying some folders and started troubleshooting the wrong issue.

[2ipm1nd]

When will the ability to rotate photos on the web be added?

[psla]

Amazing progress as always.

I get a feeling though that the main page loads significantly slower now than it used to (on the web)

Specifically,

https://my-instance/api/timeline/bucket?isArchived=false&size=MONTH&timeBucket=2024-09-01T00%3A00%3A00.000Z&withPartners=true&withStacked=true

this request takes 500ms, and returns 1.6MB, and it only starts after 900ms from page load.

It looks like that request waits for another request to finish first:

https://my-instance/api/timeline/buckets?isArchived=false&size=MONTH&withPartners=true&withStacked=true

This first request takes 550ms. So those two requests take over 1 second.

The main page loads almost instantly, but the previews take another ~1.5 seconds. I guess you first calculate the timeline view / distribution, and then fetch the first page / correct page for the timeline?

I am wondering if something changed in 1.116, because I feel like it used to be faster. (perhaps my library increased in size, as I scanned a lot of new items). Maybe it's just an illusion that it's slower.

Also - have you ever considered something more efficient than json (e.g. protos)? It feels like there is a lot of overhead in json; although I guess it should compress nicely. 1.6MB of json is quite a bit :)

In any case, I love immich. I have almost 400k images and videos in it.

[alextran1502]

Thanks for the report, definitely there are rooms for improvement.

Cc @midzelis and @mertalev fyi

[mertalev]

We're working on making the time bucket requests faster by fetching less data upfront and optimizing the DB queries. The one you mentioned is a bit unfortunate in that it relies on a full table scan in the DB to aggregate assets into date buckets, so it's a bigger challenge to make that one fast.

Re: JSON, I definitely agree and almost anything else would be better. msgpack seemed like an easy option last I checked since it's dynamic. Protobuf is the most efficient in terms of data, but the fact that it relies on code generation is clunky and its performance varies by language.