Skip to content

Releases: immich-app/immich

v1.121.0

20 Nov 16:40
Compare
Choose a tag to compare

v1.121.0

Highlights

Welcome to release v1.121.0 of Immich. This release focuses on bug fixes and performance optimization across the app. Some of the highlights below:

  • @immich/ui component library
  • Fallback to system fonts for Cyrillic letters on the mobile app
  • Multiselect using the shift key in the search result view
  • Notable fixes: album sync on the mobile app always ran when reopening the app, leading to degradation in performance and browsing

@immich/ui component library

Some of you may have seen that we added a new repository on GitHub. We have started building out a shared UI components library for Immich that will hopefully lead to a more manageable and consistent design. It’s still very much in the works, but here is a sneak peek at the button component.

image

Notable fix: album sync degrades performance on the mobile app

We fixed a bug on the server that caused visible performance degradation of the mobile app. The album syncing process is always triggered when the app is reopened instead of only syncing when there are changes on the server. This is a server fix, so we encourage you to update your server to this new release to fix this performance issue.

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

🚀 Features

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

New Contributors

Full Changelog: v1.120.2...v1.121.0

v1.120.2

12 Nov 17:50
Compare
Choose a tag to compare

v1.120.2

This patch release brings the following bug fixes:

  • Postgres now uses the correct database dump command for version 14/15/16/17.
  • Config updates were not correctly applied to some components.
  • The mobile app doesn’t initialize the date locale for some languages.

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

🐛 Bug fixes

  • fix(server): support non-default Postgres port when taking a backup by @jrasm91 in #13992
  • fix(server): thumbnail rotation when using embedded previews by @zhaoterryy in #13948
  • fix(web): use locale for scrubber label when scrolling by @michelheusschen in #14012
  • fix(mobile): make sure date locale is initialized for some languages by @alextran1502 in #14035
  • fix(server): attempt to delete failed backups immediately after failure by @zackpollard in #13995
  • fix: config updates not applying for job and storage template service by @zackpollard in #14074

📚 Documentation

New Contributors

Full Changelog: v1.120.1...v1.120.2

v1.120.1

07 Nov 15:53
Compare
Choose a tag to compare

v1.120.1

This release addresses the issues below

What's Changed

🐛 Bug fixes

  • fix(server): cannot render email template by @alextran1502 in #13957
  • fix(server): allow starting backup through API and fix pg_dumpall args when using database URLs by @dotlambda in #13970
  • fix(server): database backups compatible with deduplication by @Scrumplex in #13965
  • fix(mobile): video player not playing in full size on Android by @alextran1502 in #13986

📚 Documentation

New Contributors

Full Changelog: v1.120.0...v1.120.1

v1.120.0 - 50.000 Stars Release

06 Nov 16:47
Compare
Choose a tag to compare

v1.120.0 - 50.000 Stars Release

Welcome to release v1.120.0 of Immich. We've reached 50.000 stars on GitHub. Thank you for your love, support, and contributions to the project.

This release introduces a new built-in automatic database dump feature as well as bug fixes and enhancements. Some of the highlights include:

  • Built-in automatic database backups
  • Timeline location indicator on scrolling
  • The web is now on Svelte 5
  • Faster CPU transcoding for HDR videos
  • Notable fix: Slow server start-up time on some systems

Built-in automatic database backups

This release introduces a mechanism that automatically creates a database dump and is enabled by default. It will run at 2 AM server time and keep the last 14 backups, all of which are configurable. You can find the settings in Administration > Settings > Backup Settings

image

The database zip files are placed at <UPLOAD_LOCATION>/backups.

Below is an example of a database backup size for a library with 80_000 assets.

image

Currently, restores must be done manually, and instructions can be found in the documentation

Timeline location indicator on scrolling

The timeline on the web will now show the Month/Year information while scrolling to better indicate the viewport context.

Screen.Recording.2024-11-06.at.08.46.53.mov

Faster CPU transcoding for HDR videos

Immich now uses a faster tone-mapping implementation developed by the Jellyfin team to map colors from HDR to SDR. During testing, overall transcoding speed improved by as much as 69% for a 4K target resolution. The exact improvement will depend on hardware, source video, and transcoding settings.

Note

Note for third-party Immich distributions: as this filter only exists in jellyfin-ffmpeg, please ensure you use this build instead of a standard FFmpeg build.

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

🚀 Features

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

🌐 Translations

New Contributors

Full Changelog: v1.119.1...v1.120.0

v1.119.1

29 Oct 13:57
Compare
Choose a tag to compare

v1.119.1

This patch release adds job options to the search view context menu when bulk-selecting assets.

image

What's Changed

🌟 Enhancements

📚 Documentation

  • docs: note about Nginx reverse proxy compatibility with Let's Encrypt by @yozik04 in #13764
  • docs: Add info about album sync&folder view by @aviv926 in #12371

New Contributors

Full Changelog: v1.119.0...v1.119.1

v1.119.0

28 Oct 15:55
Compare
Choose a tag to compare

v1.119.0

Caution

The env variable for the host binding was erroneously named HOST instead of IMMICH_HOST (which is how it was listed in the docs). This has been corrected in this release.
If you were using the HOST env var in your setup before, please update it to IMMICH_HOST.

If you are using the built-in Prometheus endpoint for monitoring, please read on. If not, you can ignore this section.

The following env variables have been removed:

  • IMMICH_METRICS
  • IMMICH_API_METRICS
  • IMMICH_HOST_METRICS
  • IMMICH_IO_METRICS
  • IMMICH_JOB_METRICS

Use IMMICH_TELEMETRY_INCLUDE / IMMICH_TELEMETRY_EXCLUDE instead.

Examples:

-- IMMICH_METRICS=true
++ IMMICH_TELEMETRY_INCLUDE=all
-- IMMICH_METRICS=true
-- IMMICH_HOST_METRICS=false
++ IMMICH_TELEMETRY_INCLUDE=all
++ IMMICH_TELEMETRY_EXCLUDE=host
-- IMMICH_API_METRICS=true
-- IMMICH_HOST_METRICS=true
++ IMMICH_TELEMETRY_INCLUDE=api,host

Welcome to release v1.119.0 of Immich. This release focuses on fixing issues surrounding video encoding and thumbnail generation for a variety of old and new formats, along with minor improvements across the app. Some of the highlights below:

  • Create new OAuth users without passwords
  • Debounce email notifications for album changes
  • Improve mobile app layout on tablets
  • VAAPI hardware decoding
  • Notable fix: Face Detection using excessive RAM with OpenVINO
  • Notable fix: transcodes not playing in the mobile app in certain situations

VAAPI hardware decoding

Prior to this release, Immich only used VAAPI for video encoding; it still used the CPU for decoding and tone-mapping. This release adds end-to-end acceleration for VAAPI, making transcoding much faster with lower CPU utilization. With this addition, every supported acceleration API now has end-to-end acceleration in Immich.

If you use VAAPI hardware acceleration, you can enable hardware decoding in the transcoding settings to take advantage of this change.

Transcoding fix for mobile

When the source video is Dolby Vision, transcodes sometimes either didn't play in the mobile app, or only the audio was played. In particular, this meant that many videos captured on iOS could not be viewed on Android.

This issue has been fixed. However, existing transcodes of Dolby Vision videos created using Immich 1.114.0 - 1.118.2 will still have the issue and will need to be re-transcoded for correct playback in these cases.

To re-transcode affected videos, you can either select them in the web app and choose the Refresh encoded videos option or go to the Job Status page and click All next to Transcode Videos.

Note: you only need to do this if you encounter playback issues for these videos.

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

🚨 Breaking Changes

🚀 Features

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

🌐 Translations

New Contributors

Full Changelog: v1.118.2...v1.119.0

v1.118.2

16 Oct 19:03
Compare
Choose a tag to compare

Warning

Version v1.118.0 contains breaking changes. Read about them here.

Hotfixes

This release fixes images from Whatsapp failing to be processed, as well as an issue with video thumbnail generation failing in some cases. It also includes the FFmpeg 6.0 -> 7.0 upgrade that was scheduled for the next release, but oh well 🙃

What's Changed

🐛 Bug fixes

New Contributors

Full Changelog: v1.118.1...v1.118.2

v1.118.1

15 Oct 20:57
Compare
Choose a tag to compare

Warning

Version v1.118.0 contains breaking changes. Read about them here.

Hotfixes

This release fixes some bugs introduced in version v1.118.0, specifically an issue with Google OAuth and mobile.

What's Changed

🐛 Bug fixes

📚 Documentation

New Contributors

Full Changelog: v1.118.0...v1.118.1

v1.118.0

15 Oct 11:04
Compare
Choose a tag to compare

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:

  1. Port alignment
  2. Remove deprecated API endpoints
  3. 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.

image

Albums page

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

image

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

image image

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.

image

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.

filter-page

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.

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

🚨 Breaking Changes

🚀 Features

🌟 Enhancements

🐛 Bug fixes

Read more

v1.117.0

03 Oct 02:14
Compare
Choose a tag to compare

v1.117.0

Warning

Breaking changes

The image section of the config file structure for thumbnails and previews has changed. If you use a config file and set the image settings to custom values, these will be ignored until updated to the new structure.

…
"image": {
-  “previewFormat”: “jpeg”,
-  “previewSize”: 1440,
-  “quality”: 80,
-  “thumbnailFormat”: “webp”,
-  “thumbnailSize”: 250,
+  "thumbnail": {
+     "format": "webp",
+     "size": 250,
+     "quality": 80
+   },
+   "preview": {
+     "format": "jpeg",
+     "size": 1440,
+     "quality": 80
+   },
    "colorspace": "p3",
    "extractEmbedded": false
  }
…

Highlights

Welcome to release v1.117.0 of Immich. This release continues to bring bugfixes and additional enhancements to the app. Let's go over some of the highlights below:

  • Better folder checks
  • Download notifications (mobile)
  • Support and feedback links (web)
  • Upgrade history
  • Asset thumbnail improvements

Better folder checks

This release fixes a few more issues with the .immich related checks.

  • Ignore errors when .immich already exists, but mount checks aren't enabled
  • Add a docs page about System Integrity
  • Add an env option to skip mount checks (IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true)

Download notifications (mobile)

Downloads now show their progress and can be canceled

Support and feedback links (web)

Links have been added to the Immich web application to help users more easily find our documentation, source code, discord, etc. Also, third party packages have the option to additionally include their own links.

image

image

Upgrade history

Clicking on the server build number on the web will now also show upgrade history, in addition to other build information.

In the future we may look at combining this information with the new support/help modal.

Light Dark
image image

Asset thumbnail improvements

Combined jobs

Thumbnails are critical to keep Immich feeling snappy. We currently generate a "preview" (large), a "thumbnail" (small), and a "thumbhash" (very small) for each asset. Prior to this release each version for each asset was a separate job. Now they have been combined into a single job, per asset. This makes the jobs page much more accurate and useful. It also means thumbnails generate faster, and use less system resources (see below).

thumbnail-generation-memory-usage

In order from left to right:

  • Previews generation start on old version
  • Previews generation completed old version (starting thumbnails)
  • Thumbnail generation finished old version
  • Thumbnail generation started on new version
  • Thumbnail generation finished on new version

Common settings

Previews and thumbnails can now both set desired format, resolution, and quality settings.

image-settings

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

🚀 Features

🌟 Enhancements

🐛 Bug fixes

  • fix(server): "all" button for facial recognition deleting faces instead of unassigning them by @mertalev in #13042
  • fix(server): /search/random failing with certain options by @mertalev in #13040
  • fix(mobile): share to error by @alextran1502 in #13044
  • fix: deletedAt not set for offline assets during 1.116.0 migration by @zackpollard in #13086
  • fix(server): offline assets don't restore when coming back online by @zackpollard in #13087

📚 Documentation

🌐 Translations

New Contributors

Full Changelog: v1.116.2...v1.117.0