Skip to content

Releases: immich-app/immich

v1.122.0

05 Dec 17:02
@github-actions github-actions
v1.122.0
37220a3
Compare
Choose a tag to compare
v1.122.0

v1.122.0

Highlights

Welcome to release v1.122.0 of Immich. After a long release break, Immich is back and brings many new features with loads of bug fixes to enhance the user experience further and make Immich more delightful to use. Some of the highlights below:

  • HDR video support in the mobile app
  • Multiple URLs for machine learning service
  • Automatic switching between server URLs in the mobile app
  • Ability to hide users when searching in an Immich instance
  • Access the most recent albums through the web navigation bar
  • Custom email templates
  • Automatically clean up files left behind by interrupted uploads
  • More responsive hosted maps for users in Oceania
  • Notable fix: swiping between videos failing on older Android devices

HDR video support

Thanks to the tireless work of @mertalev and @shenlong-tanwen, HDR videos are displayed correctly in their full dynamic range using the native video player on each respective platform directly in Immich. We hope this feature brings you a more lively experience when viewing past videos.

Note

Some videos may appear warped when viewing. If this occurs, please sign out and sign back in. This only needs to be done once and does not apply to new app installations on 1.122.0 or later.

Multiple URLs for machine learning service

Remote machine learning enables folks to run machine learning on a more powerful computer, like their gaming PC. However, the expectation of constant uptime of the remote PC was a pain point for users. Immich now allows specifying multiple URLs so it can fall back to other PCs, including the local machine learning service on the same server.

You can add additional URL endpoints in the Machine Learning Settings.

image

Auto-switching server URLs in the mobile app

We are happy to bring you one of the long-requested features: the ability for the app to use the local IP address of your server while you are on your home Wi-Fi and automatically switch to alternative URLs while you are out and about, ranging from VPN URLs to public DNS addresses.

This option is located in the newly redesigned settings page in the mobile app under the Networking section. We hope this setting will simplify the networking setup you must do at home, which was previously only achievable with a split DNS setup and a local DNS server.

Note

This feature requires always granting precise location permission for the Immich app so it can read the Wi-Fi name in both foreground and background.

Android Permission iOS Permission
image image
New Settings Page Local Connection Info External Connection Info
image image image

Ability to hide users when searching in your instance

For admins hosting a public instance who don’t want users to see each other, you can now disable that mechanism in the Server Settings.

Access the most recent albums through the web navigation bar

We added a dropdown to quickly access the most recent albums directly through the navigation bar.

Custom email templates

You can now modify the email template for user registration, album creation, and album updates. This can be configured with the Email Templates setting.

image

Automatically clean up files left behind by interrupted uploads

Previously, when an upload process was canceled, the partial files on the server stayed in the upload folder as corrupted files, which wasted storage space. This release implements a mechanism that intercepts the interrupted request and cleanses the partial files.

More responsive hosted maps for users in Oceania

We have made some changes to improve the responsiveness of the hosted maps for users located in Oceania. Users located in those areas should now see their map load 2-3x faster generally as well as seeing more consistent response times.

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

  • refactor: rename searchMetadata to searchAssets by @jrasm91 in #14151

🚀 Features

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

  • docs: add developer notes about rootless docker setup by @R-Rudolf in #13250
  • docs: clarify/strengthen wording of PG deployment requirements by @mmomjian in #14294

New Contributors

Full Changelog: v1.121.0...v1.122.0

Contributors

zhujunsan, zackpollard, and 14 other contributors
Assets 11
Loading
38 Join discussion

v1.121.0

20 Nov 16:40
@github-actions github-actions
v1.121.0
98c9ae1
Compare
Choose a tag to compare
v1.121.0

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

Contributors

amorphobia, p2kmgcl, and 15 other contributors
Assets 11
Loading
4 Join discussion

v1.120.2

12 Nov 17:50
@github-actions github-actions
v1.120.2
31a1e64
Compare
Choose a tag to compare
v1.120.2

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

Contributors

zackpollard, Mraedis, and 8 other contributors
Assets 11
Loading

v1.120.1

07 Nov 15:53
@github-actions github-actions
v1.120.1
599b489
Compare
Choose a tag to compare
v1.120.1

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

Contributors

yodatak, slamp, and 7 other contributors
Assets 11
Loading

v1.120.0 - 50.000 Stars Release

06 Nov 16:47
@github-actions github-actions
v1.120.0
f1b8a93
Compare
Choose a tag to compare
v1.120.0 - 50.000 Stars Release

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

Contributors

C-Otto, zackpollard, and 13 other contributors
Assets 11
Loading
31 Join discussion

v1.119.1

29 Oct 13:57
@github-actions github-actions
v1.119.1
00dd941
Compare
Choose a tag to compare
v1.119.1

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

Contributors

yozik04, alextran1502, and aviv926
Assets 11
Loading

v1.119.0

28 Oct 15:55
@github-actions github-actions
v1.119.0
8449e78
Compare
Choose a tag to compare
v1.119.0

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

Contributors

etnoy, chriskoch, and 23 other contributors
Assets 11
Loading
14 Join discussion

v1.118.2

16 Oct 19:03
@github-actions github-actions
v1.118.2
e8015dc
Compare
Choose a tag to compare
v1.118.2

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

Contributors

lyynd and MananJain-IITJ
Assets 11
Loading

v1.118.1

15 Oct 20:57
@github-actions github-actions
v1.118.1
edd7dfb
Compare
Choose a tag to compare
v1.118.1

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

Contributors

kevincox, jrasm91, and ngtrio
Assets 11
Loading

v1.118.0

15 Oct 11:04
@github-actions github-actions
v1.118.0
8f69d9d
Compare
Choose a tag to compare
v1.118.0

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

Contributors

etnoy, C-Otto, and 19 other contributors
Assets 11
Loading
85 Join discussion