Immich export plugin via Immich API - #704
Draft
daniel-nicolai-hansten wants to merge 1 commit into
Draft
Conversation
daniel-nicolai-hansten
force-pushed
the
master
branch
from
August 3, 2026 20:15
f9e6967 to
292c9b6
Compare
Adds a new export storage target that uploads selected images to an Immich server (https://immich.app/) via its REST API. * Tracks uploads with darktable tags ("immich|asset|<id>" and "immich|change|<timestamp>") so re-exporting is cheap: unchanged images can skip contacting the server entirely when "Skip unchanged" is enabled. * "Re-export Behavior" controls what happens to a previously uploaded asset when a changed image is re-exported: delete/trash it, stack the new upload with it, both, or upload as an independent new asset. A cached asset that no longer exists (or was trashed) on the server is treated as gone and the image is uploaded fresh. * "Album mode" controls album assignment on export: no album, a custom/typed album title, copying the albums of the previous asset, or combinations of the two. The album title field is prefilled from the image's folder name. * Lua preferences configure the server URL, API key, an optional Lua module install prefix (for platforms where darktable bundles its own Lua), defaults for the export options above, and a debug logging toggle for troubleshooting. * Requires luasec, lua-cjson, and luasocket for darktable's Lua runtime.
daniel-nicolai-hansten
force-pushed
the
master
branch
from
August 4, 2026 08:47
292c9b6 to
35ce91d
Compare
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
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.
Immich export plugin, rewrite of #542
USAGE
This plugin allows you to upload selected photos to an Immich server (https://immich.app/)
Each image is tracked with darktable tags so re-exporting is safe and cheap:
If an image's change timestamp still matches the cached tag and "Skip unchanged" is
enabled, the export is skipped locally without contacting the Immich server at all.
Otherwise the plugin looks up the cached asset on the server; if it no longer exists
there, or has been trashed, it is treated as gone and the image is uploaded fresh.
When the cached asset is still present, the "Re-export Behavior" option controls what
happens to it: delete/trash it, stack the new upload with it, both, or leave it alone
and upload the image as a new, separate asset.
Album assignment is controlled by the "Album mode" option:
version of the asset already belonged to on the server
The "Album Title" field is prefilled with the folder name of the exported image when
a title-based mode is selected, but can be edited freely.
In the lua options you must specify:
The lua options also let you set the defaults for "Album mode", "Skip unchanged", and
"Re-export Behavior" shown above, so the export panel opens with your preferred choices.
An "Immich debug logging" option is also available there to log every request/response
to the darktable debug log, which is useful when troubleshooting a failed upload.