Immich Uploader

Immich Uploader is an app that scans all accessible files on your Android device, finds all images or videos, and allows you to upload them to an Immich server of your choice.

The app can mark all media files from certain places (say all media files in Downloads) to be deleted after upload.

It's a great alternative to the Immich app for devices that are not your regular phone!

Keep Android open!

If you own an Android phone, and you like using free, open source software, and you value freedom of choice, be advised that Google is planning to lock your phone down.

keepandroidopen.org has more information and some things you could do, whether you are a user or are otherwise invested.

Big media files

Immich Uploader may run into issues with big media files. There are settings that allow you to limit the size of files the app will try to upload.

If you set this to "auto", Immich Uploader will try to upload every file, big or small. It will also try and record the biggest file size it has uploaded successfully so far.

Immich permissions

In order to work, the app needs a user with a couple of permissions on your Immich instance.

• asset.upload - to be able to upload media files.
• apiKey.read - for testing the connection, used on the Settings screen (since v2.2.2)
• tag.read - for retrieving the list of Tags on your Immich instance (since v3.1.0)
• tag.asset - for applying Tags to assets (since v3.1.0)

If you use the "Check connection" buttons on the Settings view, but your Immich user does not have apiKey.read permission, the check will fail.

If your Immich user does not have tag.asset permission, uploads will still work, but media files will not be tagged.

Download

Note Due to the way Immich currently works, not all version of Immich Uploader work with all versions of Immich!

If you know how to sideload, you can also download right here:

If your Immich instance is on v3.x or later

• 2026-08-12: Immich Uploader 3.1.0
  • added ability to tag uploaded media with an Immich tag
  • added ability to specify in which order media should be uploaded
  • added backup and restore of all data
  • removed backup of work log entries
  • fixed import of settings
  • fixed the UI in some places
  • updated a couple of dependencies
• 2026-07-28: Immich Uploader 3.0.1
  • added permission needed for Android 17+ for access to local networks (fixes #14)
  • bumped one dependency
• 2026-07-14: Immich Uploader 3.0.0
  • set version to 3 to make it clear that this version is aligned with the API of Immich 3.x
  • bumped one dependency

For Immich instances before v3.x

• 2026-07-09: Immich Uploader 2.3.3
  • fixed a bug that led to failed uploads with Immich 3.x (fixed #13)
  • bumped dependencies
• 2026-07-07: Immich Uploader 2.3.2
  • fixed a bug that made the app crash on launch for specific Wifi states
  • bumped dependencies
• 2026-07-01: Immich Uploader 2.3.1
  • fixed a bug that meant that "ghost files" would show for upload
  • bumped dependencies
• 2026-06-30: Immich Uploader 2.3.0
  • added ability to direct where uploads go per category (timeline, archive, hidden, locked)
  • fixed deprecation warning in room migration test
  • bumped dependencies
• 2026-06-03: Immich Uploader 2.2.2
  • Added ability to check connection to Immich server
  • App now detects when phone leaves SSIDs (Android 12+) (fixes #9)
  • Updated dependencies
• 2026-05-21: Immich Uploader 2.2.1
  • Changed splash screen to dark (fixes "Bright splash screen in dark setting." #8)
  • Updated some dependencies
• 2026-05-14: Immich Uploader 2.2.0
  • Added "FolderSettings" screen with settings per folder/category
  • Updated some dependencies
• 2026-04-08: Immich Uploader 2.1.2
  • Fixed a bug where settings were not always saved
  • Updated some dependencies
• 2026-03-06: Immich Uploader 2.1.1
  • Moved from Compose Destinations to Navigation 3
  • Updated some dependencies
• 2026-02-19: Immich Uploader 2.1.0
  • Added automatic deletion of old (and uploaded!) files
  • Fixed dark mode
  • Improved scrolling behaviour in the UI
  • Improved display of photos in the UI
  • Added ability to specify alternative Immich server URL for use on local network
  • Added Previews to some Composables
  • Added a bunch of unit tests
  • Minor dependency updates
• 2026-02-03: Immich Uploader 2.0.6
  • Added database migrations, so you no longer start from scratch after some updates
  • Added integration tests for said migrations
  • Fixed a bug in settings where Immich Server URL and API Key would disappear after import
  • Minor updates
• 2026-02-03: Immich Uploader 2.0.5
  • Improved display of not yet uploaded files, now shows new vs new + failed
  • Increased frequency of upload batches (from every 30 to every 10 minutes)
  • Surfaced upload errors on new 'Upload log' screen
  • Fixed UI oddities and quirks
  • Minor updates
• 2026-01-30: Immich Uploader 2.0.4
  • Rebuilt the input fields for texts and numbers
  • Fixed a bug where "not yet backed up" was interpreted differently in different places
  • Minor updates
• 2026-01-23: Immich Uploader 2.0.3
  • Fixed home screen display while uploading, again
  • Fixed input lag for Immich server URL & API Key fields on Settings screen
  • Added big warning to Home screen when Immich server credentials are missing
  • Fixed export/import of settings (a few were missing)
  • Disable automatic upload if anything is wrong with Immich server credentials
  • More underlying updates
• 2026-01-20: Immich Uploader 2.0.2
  • Fixed home screen display while uploading
  • Some underlying updates
• 2026-01-18: Immich Uploader 2.0.1
  • Added settings for limiting size of uploaded files automatically, or manually
  • Changed upload file size limit
  • Added settings for number of files per batch
• 2026-01-15: Immich Uploader 2.0.0
  • Changed media discovery and upload to run in the background
  • Added a screen that shows all media assets
  • Added filter options on the all assets view
  • Improved handling of Immich Server URL in settings
  • Added a log that can be exported
  • Added automatic pruning of said log
  • Added automatic backup to a file for said log
  • Made a lot of visual improvements, I feel
  • Fixed bugs
  • Replaced JSON lib
• 2025-05-11: Immich Uploader 1.1.1
  • Fixed deleting files on Android 11 and above
• 2025-05-09: Immich Uploader 1.1.0
  • Added screen that helps with deleting assets after upload
  • Added ability to upload single asset by tapping it
  • Fixed preferences handling after edit
• 2025-05-03: Immich Uploader 1.0.1

Open Source

Source code for is available on codeberg.org.