Immich

Immich backs up photos from a Light Phone III to a self-hosted Immich server. It is an independent community project, not an official Light or Immich app.

Install with Light Phone Manager

1. Enable USB debugging on the phone and connect it by USB.
2. Open Light Phone Manager.
3. Drag Immich-0.1.0.apk onto the manager window, or select Install APK file.
4. Allow USB debugging on the phone if prompted.

You can also add this repository to Light Phone Manager after publishing the APK as a GitHub Release asset. The asset name must not contain debug.

Build a release APK

The release APK must always use the same signing key. Android will reject an update signed with a different key.

The embedded Light Keyboard dependency is downloaded from GitHub Packages. Add these values to the ignored android/local.properties file, or provide them as the GH_PACKAGES_USER and GH_PACKAGES_TOKEN environment variables:

gpr.user=your-github-username
gpr.key=github-token-with-read-packages

1. Create and securely back up android/release.jks.
2. Copy android/keystore.properties.example to android/keystore.properties and enter the key details.
3. Run ./gradlew assembleRelease from android/ with JDK 17.
4. Install app/build/outputs/apk/release/app-release.apk, or rename it to Immich-0.1.0.apk before publishing it as a GitHub Release asset.

Do not commit the signing key or keystore.properties.