圖標

Immich Uploader

App that can upload media files to your Immich instance.
新版本 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
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.

版本

雖然在下方可選擇下載 APK 檔案,但要留意這樣的安裝方式將不會收到更新通知,是一種較不安全的下載方法。建議您先安裝 F-Droid 用戶端使用。

下載 F-Droid
  • 版本 3.1.0 (24) 建議 於 2026 年 8 月 14 日新增

    arm64-v8a armeabi-v7a x86 x86_64

    此版本需要 Android 10 或更高的版本。

    此套件包由原開發者建置和簽署,並保證與此原始碼 Tarball 保持一致。

    權限
    • 僅可在前景中取得概略位置
      只有在你使用時,這個應用程式才能透過定位服務取得你的概略位置。你必須在裝置上開啟定位服務,這個應用程式才能取得位置資訊。
    • 僅可在前景中取得精確位置
      只有在你使用時,這個應用程式才能透過定位服務取得你的精確位置。你必須在裝置上開啟定位服務,這個應用程式才能取得位置資訊。這麼做可能會增加電池用量。
    • android.permission.ACCESS_LOCAL_NETWORK
    • 讀取你的媒體收藏的位置資訊
      允許應用程式讀取你的媒體收藏的位置資訊。
    • 查看網路連線
      允許應用程式查看網路連線相關資訊,像是有哪些網路,以及有沒有連上。
    • 查看 Wi-Fi 連線
      允許應用程式查看 Wi-Fi 網路相關資訊,例如是否已啟用 Wi-Fi,以及所連上 Wi-Fi 裝置的名稱。
    • 執行前景服務
      允許應用程式使用前景服務。
    • 擁有完整的網路存取權
      允許應用程式建立網路通訊端及使用自訂網路通訊協定。瀏覽器和其他應用程式會提供將資料傳輸到網際網路的方法,因此不需要這項權限也能將資料傳輸到網際網路。
    • 讀取共用儲存空間中的內容
      允許這個應用程式讀取共用儲存空間中的內容。
    • 讀取共用儲存空間中的圖片檔案
      允許應用程式讀取共用儲存空間中的圖片檔案。
    • 讀取共用儲存空間中的影片檔案
      允許應用程式讀取共用儲存空間中的影片檔案。
    • 啟動時執行
      允許應用程式在系統完成開機程序後立刻自行啟動。這會增加手機的開機時間,而且會因為系統一直執行該應用程式導致手機的整體運作速度變慢。
    • 防止手機休眠
      允許應用程式防止手機進入休眠狀態。

    下載 APK 4.6 MiB PGP 簽章 | 建置紀錄

  • 新版本 3.0.1
    - added permission needed for Android 17+ for access to local networks (fixes #14)
    - bumped one dependency
  • 版本 3.0.1 (23) - 於 2026 年 7 月 31 日新增

    arm64-v8a armeabi-v7a x86 x86_64

    此版本需要 Android 10 或更高的版本。

    此套件包由原開發者建置和簽署,並保證與此原始碼 Tarball 保持一致。

    權限
    • 僅可在前景中取得概略位置
      只有在你使用時,這個應用程式才能透過定位服務取得你的概略位置。你必須在裝置上開啟定位服務,這個應用程式才能取得位置資訊。
    • 僅可在前景中取得精確位置
      只有在你使用時,這個應用程式才能透過定位服務取得你的精確位置。你必須在裝置上開啟定位服務,這個應用程式才能取得位置資訊。這麼做可能會增加電池用量。
    • android.permission.ACCESS_LOCAL_NETWORK
    • 讀取你的媒體收藏的位置資訊
      允許應用程式讀取你的媒體收藏的位置資訊。
    • 查看網路連線
      允許應用程式查看網路連線相關資訊,像是有哪些網路,以及有沒有連上。
    • 查看 Wi-Fi 連線
      允許應用程式查看 Wi-Fi 網路相關資訊,例如是否已啟用 Wi-Fi,以及所連上 Wi-Fi 裝置的名稱。
    • 執行前景服務
      允許應用程式使用前景服務。
    • 擁有完整的網路存取權
      允許應用程式建立網路通訊端及使用自訂網路通訊協定。瀏覽器和其他應用程式會提供將資料傳輸到網際網路的方法,因此不需要這項權限也能將資料傳輸到網際網路。
    • 讀取共用儲存空間中的內容
      允許這個應用程式讀取共用儲存空間中的內容。
    • 讀取共用儲存空間中的圖片檔案
      允許應用程式讀取共用儲存空間中的圖片檔案。
    • 讀取共用儲存空間中的影片檔案
      允許應用程式讀取共用儲存空間中的影片檔案。
    • 啟動時執行
      允許應用程式在系統完成開機程序後立刻自行啟動。這會增加手機的開機時間,而且會因為系統一直執行該應用程式導致手機的整體運作速度變慢。
    • 防止手機休眠
      允許應用程式防止手機進入休眠狀態。

    下載 APK 4.5 MiB PGP 簽章 | 建置紀錄

  • 新版本 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
  • 版本 3.0.0 (22) - 於 2026 年 7 月 15 日新增

    arm64-v8a armeabi-v7a x86 x86_64

    此版本需要 Android 10 或更高的版本。

    此套件包由原開發者建置和簽署,並保證與此原始碼 Tarball 保持一致。

    權限
    • 僅可在前景中取得概略位置
      只有在你使用時,這個應用程式才能透過定位服務取得你的概略位置。你必須在裝置上開啟定位服務,這個應用程式才能取得位置資訊。
    • 僅可在前景中取得精確位置
      只有在你使用時,這個應用程式才能透過定位服務取得你的精確位置。你必須在裝置上開啟定位服務,這個應用程式才能取得位置資訊。這麼做可能會增加電池用量。
    • 讀取你的媒體收藏的位置資訊
      允許應用程式讀取你的媒體收藏的位置資訊。
    • 查看網路連線
      允許應用程式查看網路連線相關資訊,像是有哪些網路,以及有沒有連上。
    • 查看 Wi-Fi 連線
      允許應用程式查看 Wi-Fi 網路相關資訊,例如是否已啟用 Wi-Fi,以及所連上 Wi-Fi 裝置的名稱。
    • 執行前景服務
      允許應用程式使用前景服務。
    • 擁有完整的網路存取權
      允許應用程式建立網路通訊端及使用自訂網路通訊協定。瀏覽器和其他應用程式會提供將資料傳輸到網際網路的方法,因此不需要這項權限也能將資料傳輸到網際網路。
    • 讀取共用儲存空間中的內容
      允許這個應用程式讀取共用儲存空間中的內容。
    • 讀取共用儲存空間中的圖片檔案
      允許應用程式讀取共用儲存空間中的圖片檔案。
    • 讀取共用儲存空間中的影片檔案
      允許應用程式讀取共用儲存空間中的影片檔案。
    • 啟動時執行
      允許應用程式在系統完成開機程序後立刻自行啟動。這會增加手機的開機時間,而且會因為系統一直執行該應用程式導致手機的整體運作速度變慢。
    • 防止手機休眠
      允許應用程式防止手機進入休眠狀態。

    下載 APK 4.5 MiB PGP 簽章 | 建置紀錄