<p>Immich Uploader is a small app that discovers media files on your Android device, then uploads them to your Immich instance.</p> <p>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).</p> <p>It can also apply Tags to media files after successful upload. Again, this can be configured by type of file.</p> <h2>Permissions</h2> <h3>Android</h3> <p>The app needs INTERNET permissions for the upload as well as access to your media files, which it will explicitly ask for.<p> <p>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.</p> <h3>Immich</h3> <p>The app connects to your Immich instance. It needs an API Key to do so.</p> <p>You can use your standard Immich user, or you can (should) create a user specifically for Immich Uploader.</p> <p>The user must have the following permissions on your Immich instance:</p> <ul> <li><code>asset.upload</code> - for uploading media assets</li> <li><code>apiKey.read</code> - for testing the connection, used on the Settings screen (since v2.2.2)</li> <li><code>tag.read</code> - for retrieving the list of Tags on your Immich instance (since v3.1.0)</li> <li><code>tag.asset</code> - for applying Tags to assets (since v3.1.0)</li> </ul> <p>If you use the "Check connection" buttons on the Settings view, but your Immich user does not have <code>apiKey.read</code> permission, the check will fail.</p> <p>If your Immich user does not have <code>tag.read</code> permission, the app can not download Tags from the Immich instance, and if they do not have <code>tag.asset</code> permission, uploads will still work, but media files will not be tagged.</p>