You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This release includes several quality of life improvements and another round of bug fixes. Keep reading below for the complete highlights.
Highlights
Upload wakelock (web)
Undo archive (web)
Filter assets by server filepath (workflows)
Quick navigate to maintenance page (web)
Better slideshow button accessibility (web)
OIDC role claim sync improvements (OAuth)
Invalidate sessions on password reset (admin-cli)
Upload wakelock (web)
Similar to mobile, the web application will now automatically acquire a wakelock to prevent the screen from dimming while uploads are happening. This feature will require an HTTPS connection.
Undo archive (web)
After archiving assets, the success notification now has an “undo” button to undo the action.
Filter assets by server filepath (workflows)
The asset file filter has a new option “Use path”. When set to true, it will filter based on the actual path on the server rather than the original file name.
Filter assets by EXIF metadata (workflows)
A new workflow filter has been added that allows you to filter assets based on their EXIF metadata fields. For now it only supports string comparisons, with numerical comparisons expected to come soon.
Quick navigate to maintenance page (web)
The command palette (CTRL+K or /) now includes an item for the maintenance page.
Better slideshow button visibility (web)
The slideshow buttons on the web are now wrapped in a container with a backdrop blur, making them easier to view when the current asset is very light.
OIDC role claim sync improvements (OAuth)
The OAuth integration in Immich supports setting an initial isAdmin value for new users via a role claim. This same process has been updated to now syncisAdmin on subsequent logins. Additionally, the role claim now supports both single values (immich_role: 'admin') in addition to lists of values ( immich_role: ["admin", "user"]), making in more flexible.
Invalidate sessions on password reset (admin-cli)
When using the admin command line interface to reset a password, there is now a new option to invalidate existing sessions.
immich-admin reset-admin-password
Found Admin:
- ID=e65e6f88-2a30-4dbe-8dd9-1885f4889b53
- OAuth ID=
- Email=admin@example.com
- Name=Immich Admin
? Please choose a new password (optional) immich-is-cool
? Invalidate existing sessions? Yes
The admin password has been updated.
Date range for map (mobile)
Similar to web, mobile now also supports filtering the map for assets within a given date range.
What's Changed
🚨 Breaking Changes
chore(mobile): drop support for iOS 14 by @agg23 in #29780
🚀 Features
feat(cli): Add --visibility flag to immich CLI upload subcommand by @yuxincs in #29614
we push to our own F-Droid repo at https://app.futo.org/fdroid/repo now. If you're using F-Droid, please pull the application from there from now on
fixes an issue where LivePhotos upload from the background isn't showing up.
[!Note]
In some specific circumstances, newly uploaded Live Photos could have broken thumbnails. If you see any such cases, please run the "missing" job for thumbnails or wait for the respective nightly job to clear it up.
What's Changed
🚀 Features
feat: publish app releases to FUTO F-Droid repo by @bo0tzz in #29804
🐛 Bug fixes
fix(web): closing plugin method picker selects "unknown" method by @benbeckford in #29784
After months of hard work from the team and our amazing contributors, we're thrilled to announce the next major version of Immich: v3.0.0! 🎉
Breaking changes
This release includes several breaking changes; read the full migration guide here. It's worth mentioning that many of the breaking changes are updates to API endpoints and affect only third-party tools that integrate with Immich's API. For the vast majority of users, updating works exactly as it always has.
First, update the IMMICH_VERSION in your .env file to v3:
- IMMICH_VERSION=v2+ IMMICH_VERSION=v3
Then run the usual update commands:
docker compose pull && docker compose up -d
Release candidates
If you missed it, v3.0.0 was the first time we used release candidates, also known as prereleases. Release candidates are tested but not yet official releases of Immich, and they allow us to find and fix any outstanding bugs before a final release. If you would like to be notified about release candidates directly through Immich, you can change the release channel from "Stable" to "Release candidate" in the Admin settings > Version check options (here).
New Merch
As part of this release, we're happy to announce we also have some new swag for you!
Kids clothing: For those who are likely the reason for your Immich library's size
Colored embroidery: We now have clothes with a full color embroidered Immich logo
Now, let's get right into all the new features in this release:
Mobile non-destructive editing
Workflows (preview)
Background backup improvement
Recently added page
Integrity checks
Slideshow on mobile app
HLS and real-time video transcoding (preview)
New video player for web
Open photo in Immich as gallery on Android
OCR on mobile app
Upload asset directly to album on the mobile app
Option to select image size when sharing on the mobile app
Timeline performance improvement for browsing a large amount of assets in a single month
Mobile non-destructive editing
This is a follow-up to Image Editing on the web, which was released in v2.5.0. This feature allows you to make non-destructive edits to your photos inside of Immich. Until now, the mobile editor used a completely different system that created new assets instead of editing the photo in place.
With this update, we bring a new, easier-to-use editor to mobile devices that has the same features as the web version. You can now edit photos directly in the mobile app, including cropping, rotating, and adjusting your images without ever touching the original file. Similar to the web, edits are non-destructive, so you can revisit or revert them at any time. You can even make edits on mobile and then adjust them on the web later!
Some features from the previous mobile editing implementation have been removed including:
Recoloring photos
Editing live photos
Editing local assets
We have plans to bring some of these capabilities back in future releases.
Workflows (preview)
The first preview of Workflows is here! Workflows let you automate actions in your library by chaining triggers, filters, and actions together with a drag-and-drop builder. This is the foundation for many exciting automations to come, and we'd love your feedback as we continue building on it.
From there, you can either create a new blank workflow or browse the premade templates to get a basic understanding of how workflows can be used.
Workflows editor
In the workflows editor, you can switch between the Visual or JSON editor. The visual editor is nice for building out the workflow; the JSON editor is nice for sharing and receiving workflow content from others.
In each workflow, there is a trigger and a sequence of steps.
Trigger: this is the entry point of each workflow; when the trigger occurs, the steps are evaluated.
Steps: they include Filters (conditions) and Actions (effects); they can be combined to produce the desired effect of the use case you aim for.
Sharing a workflow
You can share the workflow you made with others in two ways: text and JSON. Text is nice for sharing on a forum or for show-and-tell content. JSON is nice for others to make an exact copy of your workflow's configuration.
You can copy the text in the workflows summary panel on the lower right of the screen
You can share the JSON content from the copy workflows button in the app bar, switch to the JSON editor, or use the Show schema button in the context menu in the workflows list
[!NOTE]
Please use this discussion thread to propose new ideas of triggers and actions. We are looking for extensive feedback and suggestions from you all.
Background backup improvements
Background backup on Android is now significantly more reliable. Previously, the background backup on Android was limited to newly taken photos. Now, the app uses a new periodic task scheduler, which allows you to upload your entire library in the background, and it plays nicer with Android's background execution limits, properly cleans up tasks, and warns you when battery optimization and notification settings might interfere with backups.
On iOS, the background refresh task now runs its sync and upload work in parallel, so uploads actually start within the short time window iOS allows.
Recently added page
A new "Recently Added" page on the web and mobile lets you browse your library sorted by when assets were added to Immich, rather than when they were taken. This makes it easier to find what's new when browsing a new batch of imports. You can find the new page in the "Explore" tab on the web and in the "Search" tab on mobile.
Integrity checks
The maintenance page has gotten a new addition: integrity reports! Immich will scan its directories on your file system, and compare it to what it has stored in its database. If there are deviations, they will be surfaced as
untracked, if there is a file in Immich's directories that Immich does not know of
missing, if Immich references a file in its database that does not exist in that place (anymore)
a checksum mismatch, if the checksum of the file on disk does not match the checksum Immich has stored for that file. Typically, this would happen through file corruption but could also be the result of a bad rename.
You can configure when and how long the job runs each night.
Slideshow (mobile)
The slideshow experience comes to mobile! You can now sit back and let your photos and videos play across the screen, just like on the web.
HLS and Real-Time Video transcoding (preview)
Immich can now transcode videos on-the-fly without needing to generate offline transcodes. This has been a long-requested feature with many benefits:
Quality switching (both manual and automatic)
Transcoding to the best codecs supported by the client
Lower storage overhead when offline transcoding is disabled
HDR for compatible clients (not implemented yet)
Remuxing rather than transcoding the original when bandwidth allows it (not implemented yet)
Please note that this feature is still experimental and can change behavior from version to version. It's currently only implemented in the web app, with the mobile app implementation in progress.
To enable real-time transcoding, go to the video transcoding settings (scroll down). Offline transcoding isn't directly affected by enabling it, so if you'd like to disable offline transcoding, you should also adjust the transcode policy.
[!NOTE]
For assets imported prior to v3, you will also need to re-run Metadata Extraction in the job panel for them to be re-processed.
Keep in mind that your server needs to be powerful enough to transcode in real-time for this feature to work well. Hardware acceleration is recommended, but not required, when using this feature.
New video player for web
A new custom video player on the web app ensures all your devices share the same controls and layout, matching the Immich design. Some basic functions, like changing the playback rate, are available. This should also fix a lot of the problems on iOS, where the OS's controls are hidden behind the Immich navbar.
Open photos in Immich as a gallery on Android
Immich can now act as a gallery/image viewer app on Android. Tap a photo or video in another app, choose Immich, and it opens directly in the asset viewer with options to share the file or upload it to your library.
This is the first iteration of the feature, and refinements to how Immich recognizes files that are already in your library are on the way
OCR on the mobile app
The asset viewer now has a toggle that highlights recognized text in a photo, and you can select and copy it directly from the image.
Upload assets directly to an album on mobile
You can now upload local photos directly to an album in the mobile app, including from the asset bottom sheet, instead of uploading first and organizing later. A small change that removes a lot of friction from the backup-and-organize flow.
Select image size when sharing on mobile
When sharing photos from the mobile app, you can now choose the image size before sending; it is handy for keeping shared files small for messaging apps while preserving the option to share at full quality when needed.
You can change the default behavior in the App Settings > Preferences
You can also pick the option when sharing on-the-fly by long pressing the Share button
Timeline performance Improvements
Browsing months with a large number of assets is now dramatically smoother and prevents the browser tab from locking up when your instance encounters that scenario.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
v2.7.5→v3.1.0v2.7.5→v3.1.0Release Notes
immich-app/immich (ghcr.io/immich-app/immich-machine-learning)
v3.1.0Compare Source
Welcome to Immich
v3.1.0!This release includes several quality of life improvements and another round of bug fixes. Keep reading below for the complete highlights.
Highlights
Upload wakelock (web)
Similar to mobile, the web application will now automatically acquire a wakelock to prevent the screen from dimming while uploads are happening. This feature will require an HTTPS connection.
Undo archive (web)
After archiving assets, the success notification now has an “undo” button to undo the action.
Filter assets by server filepath (workflows)
The asset file filter has a new option “Use path”. When set to true, it will filter based on the actual path on the server rather than the original file name.
Filter assets by EXIF metadata (workflows)
A new workflow filter has been added that allows you to filter assets based on their EXIF metadata fields. For now it only supports string comparisons, with numerical comparisons expected to come soon.
Quick navigate to maintenance page (web)
The command palette (
CTRL+Kor/) now includes an item for the maintenance page.Better slideshow button visibility (web)
The slideshow buttons on the web are now wrapped in a container with a backdrop blur, making them easier to view when the current asset is very light.
OIDC role claim sync improvements (OAuth)
The OAuth integration in Immich supports setting an initial
isAdminvalue for new users via a role claim. This same process has been updated to now syncisAdminon subsequent logins. Additionally, the role claim now supports both single values (immich_role: 'admin') in addition to lists of values (immich_role: ["admin", "user"]), making in more flexible.Invalidate sessions on password reset (admin-cli)
When using the admin command line interface to reset a password, there is now a new option to invalidate existing sessions.
Date range for map (mobile)
Similar to web, mobile now also supports filtering the map for assets within a given date range.
What's Changed
🚨 Breaking Changes
🚀 Features
🌟 Enhancements
🐛 Bug fixes
📚 Documentation
🌐 Translations
New Contributors
Full Changelog: immich-app/immich@v3.0.3...v3.1.0
v3.0.3Compare Source
v3.0.3
What's Changed
🚀 Features
🐛 Bug fixes
📚 Documentation
🌐 Translations
New Contributors
Full Changelog: immich-app/immich@v3.0.2...v3.0.3
v3.0.2Compare Source
v3.0.2
This patch release addresses various bugs from v3 release and adds an additional filter to workflows
What's Changed
🌟 Enhancements
🐛 Bug fixes
📚 Documentation
🌐 Translations
New Contributors
Full Changelog: immich-app/immich@v3.0.1...v3.0.2
v3.0.1Compare Source
v3.0.1
What's Changed
🚀 Features
🐛 Bug fixes
🌐 Translations
Full Changelog: immich-app/immich@v3.0.0...v3.0.1
v3.0.0Compare Source
v3.0.0
Welcome to Immich
v3.0.0!After months of hard work from the team and our amazing contributors, we're thrilled to announce the next major version of Immich:
v3.0.0! 🎉Breaking changes
This release includes several breaking changes; read the full migration guide here. It's worth mentioning that many of the breaking changes are updates to API endpoints and affect only third-party tools that integrate with Immich's API. For the vast majority of users, updating works exactly as it always has.
How to update
First, update the
IMMICH_VERSIONin your.envfile tov3:Then run the usual update commands:
docker compose pull && docker compose up -dRelease candidates
If you missed it,
v3.0.0was the first time we used release candidates, also known as prereleases. Release candidates are tested but not yet official releases of Immich, and they allow us to find and fix any outstanding bugs before a final release. If you would like to be notified about release candidates directly through Immich, you can change the release channel from "Stable" to "Release candidate" in theAdmin settings > Version checkoptions (here).New Merch
As part of this release, we're happy to announce we also have some new swag for you!
Check it out now at https://immich.store!
Highlights
Now, let's get right into all the new features in this release:
Mobile non-destructive editing
This is a follow-up to Image Editing on the web, which was released in
v2.5.0. This feature allows you to make non-destructive edits to your photos inside of Immich. Until now, the mobile editor used a completely different system that created new assets instead of editing the photo in place.With this update, we bring a new, easier-to-use editor to mobile devices that has the same features as the web version. You can now edit photos directly in the mobile app, including cropping, rotating, and adjusting your images without ever touching the original file. Similar to the web, edits are non-destructive, so you can revisit or revert them at any time. You can even make edits on mobile and then adjust them on the web later!
Some features from the previous mobile editing implementation have been removed including:
We have plans to bring some of these capabilities back in future releases.
Workflows (preview)
The first preview of Workflows is here! Workflows let you automate actions in your library by chaining triggers, filters, and actions together with a drag-and-drop builder. This is the foundation for many exciting automations to come, and we'd love your feedback as we continue building on it.
You can access the feature from Utilities > Workflows on the web.
From there, you can either create a new blank workflow or browse the premade templates to get a basic understanding of how workflows can be used.
Workflows editor
In the workflows editor, you can switch between the Visual or JSON editor. The visual editor is nice for building out the workflow; the JSON editor is nice for sharing and receiving workflow content from others.
In each workflow, there is a trigger and a sequence of steps.
Sharing a workflow
You can share the workflow you made with others in two ways: text and JSON. Text is nice for sharing on a forum or for show-and-tell content. JSON is nice for others to make an exact copy of your workflow's configuration.
You can copy the text in the workflows summary panel on the lower right of the screen
You can share the JSON content from the copy workflows button in the app bar, switch to the JSON editor, or use the
Show schemabutton in the context menu in the workflows listBackground backup improvements
Background backup on Android is now significantly more reliable. Previously, the background backup on Android was limited to newly taken photos. Now, the app uses a new periodic task scheduler, which allows you to upload your entire library in the background, and it plays nicer with Android's background execution limits, properly cleans up tasks, and warns you when battery optimization and notification settings might interfere with backups.
On iOS, the background refresh task now runs its sync and upload work in parallel, so uploads actually start within the short time window iOS allows.
Recently added page
A new "Recently Added" page on the web and mobile lets you browse your library sorted by when assets were added to Immich, rather than when they were taken. This makes it easier to find what's new when browsing a new batch of imports. You can find the new page in the "Explore" tab on the web and in the "Search" tab on mobile.
Integrity checks
The maintenance page has gotten a new addition: integrity reports! Immich will scan its directories on your file system, and compare it to what it has stored in its database. If there are deviations, they will be surfaced as
You can configure when and how long the job runs each night.
Slideshow (mobile)
The slideshow experience comes to mobile! You can now sit back and let your photos and videos play across the screen, just like on the web.
HLS and Real-Time Video transcoding (preview)
Immich can now transcode videos on-the-fly without needing to generate offline transcodes. This has been a long-requested feature with many benefits:
Please note that this feature is still experimental and can change behavior from version to version. It's currently only implemented in the web app, with the mobile app implementation in progress.
To enable real-time transcoding, go to the video transcoding settings (scroll down). Offline transcoding isn't directly affected by enabling it, so if you'd like to disable offline transcoding, you should also adjust the transcode policy.
Keep in mind that your server needs to be powerful enough to transcode in real-time for this feature to work well. Hardware acceleration is recommended, but not required, when using this feature.
New video player for web
A new custom video player on the web app ensures all your devices share the same controls and layout, matching the Immich design. Some basic functions, like changing the playback rate, are available. This should also fix a lot of the problems on iOS, where the OS's controls are hidden behind the Immich navbar.
Open photos in Immich as a gallery on Android
Immich can now act as a gallery/image viewer app on Android. Tap a photo or video in another app, choose Immich, and it opens directly in the asset viewer with options to share the file or upload it to your library.
This is the first iteration of the feature, and refinements to how Immich recognizes files that are already in your library are on the way
OCR on the mobile app
The asset viewer now has a toggle that highlights recognized text in a photo, and you can select and copy it directly from the image.
Upload assets directly to an album on mobile
You can now upload local photos directly to an album in the mobile app, including from the asset bottom sheet, instead of uploading first and organizing later. A small change that removes a lot of friction from the backup-and-organize flow.
Select image size when sharing on mobile
When sharing photos from the mobile app, you can now choose the image size before sending; it is handy for keeping shared files small for messaging apps while preserving the option to share at full quality when needed.
You can change the default behavior in the
App Settings > PreferencesYou can also pick the option when sharing on-the-fly by long pressing the
SharebuttonTimeline performance Improvements
Browsing months with a large number of assets is now dramatically smoother and prevents the browser tab from locking up when your instance encounters that scenario.
Support Immich
If you find the project helpful, you can support Immich by purchasing a product key at https://buy.immich.app or our merchandise at https://immich.store
What's Changed
🚨 Breaking Changes
🫥 Deprecated Changes
🔒 Security
🚀 Features
Configuration
📅 Schedule: (in timezone America/New_York)
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about these updates again.
This PR has been generated by Mend Renovate.