v1.118.0

版本发布时间: 2024-10-15 19:04:52

immich-app/immich最新发布版本:v1.123.0(2024-12-18 00:41:21)

v1.118.0

Welcome to release v1.118.0 of Immich. This version comes with several breaking changes, and also improvements to the mobile app UI and UX, a new documentation home page, as well as bug fixes and enhancements across the app. We hope you enjoy this release!

[!WARNING]

Breaking changes

This release includes the following breaking changes:

Port alignment

Remove deprecated API endpoints

Remove deprecated start.sh arguments

1. Port alignment

We aligned the internal port of the immich-server to be similar to the binding port. Please make the following change to your docker-compose.yml file under the immich-server section. Reverse proxies using port 3001 also need to be updated to use port 2283.

services:
  immich-server:
    container_name: immich_server
    ...
    ports:
-    - 2283:3001
+    - 2283:2283
    ...

2. Remove deprecated API endpoints

The following endpoints were previously deprecated and have been removed, if you are a community project maintainer and using one of the endpoints below, please make sure to make changes to your project:

/api/server-info/* has been removed. Use /api/server/* instead.
/api/people/:id/assets has been removed. Use /api/search/metadata instead.

[!NOTE] This includes /api/server-info/ping, /api/server-info/version, /api/server-features, /api/server-info/config, /api/server-info/statistics, and others.

3. Remove deprecated `start.sh` arguments

The following docker commands have been removed:

start.sh immich
start.sh microservices

Follow the steps below to align docker-compose.yml with the default setup.

[!NOTE] These steps are only required if you still have the immich-microservices section in your docker-compose.yml or didn't follow the previous instructions to remove the command section. If you don't have the mentioned content below, you can ignore this

1. Update `docker-compose.yml`

Remove the command line from immich-server and the entire immich-microservices service section as shown below.

services:
  immich-server:
    container_name: immich_server
    ...
    :
-   command: [ "start.sh", "immich" ]
    ...
    
-  immich-microservices:
-    container_name: immich_microservices
-    ...
-    :
-    command: [ "start.sh", "microservices" ]
-    ...

2. Remove the running `immich-microservices` container

Run docker compose down --remove-orphans after updating docker-compose.yml to remove the old immich-microservices container.

Highlights

Some of the highlights for this release include the following:

Mobile UI/UX improvement
Option to refresh face detection
Color filters for editing photos
Timezone improvements
Deprecated release notes section
Better JPEG compression
Multi-GPU support for ML

Mobile UI/UX improvement

Thank you all for the great feedback from the dicussion we made a month ago about the proposed changes to the mobile app layout. We hope the following changes will provide more fluid experience when browing and managing your photos and videos.

Navigation bar

Photos and albums are the two most used pages. To make them more accessible, we replaced the Sharing page with a new Albums page where you can find all of the album related features and functions.

Albums page

This new page allows users to quickly view, sort, search, filter, create, and manage albums.

Library page

The library page now includes quick access buttons to various views, including

Favorites
Archived
Shared links
Trash
People
Places
Device albums
Partner sharing

Search page

Many of the items that were previously on this page have been moved to the Library page, mentioned above. As a result, the search page is less cluttered and includes quick access search chips and queries. Also, clicking on the search navbar item a second time will focus on the search bar and open the keyboard for easy access.

Color filters for editing photos

This release introduces colors filter option in the edit menu on the mobile app. You can apply a set of presets colors to your photo. Thanks @Yuvi-raj-P for your contribution.

Timezone improvements

Images without timezones could previously show up incorrectly in the timeline if the server had a timezone (TZ=...) set. This has been fixed and can be corrected by running metadata extraction on all assets.

Deprecated release notes section

Future releases will now include a "Deprecated" section in the release notes, including details of API endpoints and other changes that will become breaking changes in a future release. Moving forward, we plan to use this section of the release notes as our primary communication method for these types of changes.

Refresh face detection

Assets now have a Refresh faces option to update the set of detected faces based on the current face detection threshold. Likewise, there is a new Refresh button for Face Detection in the Jobs page that does the same for all assets.

Importantly, this does not clear all recognized people like the All button (renamed to Reset). If you find that a different detection threshold works better for your library and want to apply that new value to existing assets, Refresh will simply add or remove faces to apply this change.

It will only ever delete faces detected through machine learning, not EXIF. Speaking of EXIF-sourced faces, they can now be used to recognize detected faces as a result of this feature. This means the facial recognition process can share the same people listed in face metadata instead of duplicating them.

Better JPEG compression

Immich now uses Jpegli, a new library leveraging the advancements of JPEG XL to shrink JPEG file size at the same (or higher) quality. This change narrows the gap between JPEG and WebP compression considerably, especially at high quality.

Multi-GPU support for ML

It is now possible for a single instance of the machine learning service to use more than one GPU. Previously, this required several services and a load balancer in front. See the documentation for instructions.