Immich Uploader is a small app that discovers media files on your Android device, then uploads them to your Immich instance.

The app can be configured to remove media files from your device after successful updates. This can be configured individually by type of file (Photo, Screenshot, Download, or Others).

It can also apply Tags to media files after successful upload. Again, this can be configured by type of file.

Permissions

Android

The app needs INTERNET permissions for the upload as well as access to your media files, which it will explicitly ask for.

On devices running Android 17 or later, it also needs ACCESS_LOCAL_NETWORK permissions if you want to use a local server URL when your Android device is on the same network as your Immich server. This usually speeds up upload a great deal.

Immich

The app connects to your Immich instance. It needs an API Key to do so.

You can use your standard Immich user, or you can (should) create a user specifically for Immich Uploader.

The user must have the following permissions on your Immich instance:

• asset.upload - for uploading media assets


• 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.read permission, the app can not download Tags from the Immich instance, and if they do not have tag.asset permission, uploads will still work, but media files will not be tagged.