📱 Apps

Apple TV

ImmichFrame is available on the Apple TV App Store.

See also: ImmichFrame Apple TV repository

iOS and iPadOS

You can "install" ImmichFrame as a PWA by opening in a browser and going to Share Menu-Add to Homescreen.

Android

The Android-Version of ImmichFrame is available on the Google Play Store. Download it via the store for automatic updates. You can also sideload via APK available in Releases.

See also: ImmichFrame Android repository

Remote Control

The Android app runs a small local HTTP server on port 53287 that accepts commands dim, undim, next, previous, pause, settings, brightness?value=x.
Brightness value must be a float between 0.00 and 1.00, or -1.00 to use the system default.
Examples:
curl http://192.168.0.136:53287/next
curl "http://192.168.0.136:53287/brightness?value=0.5"

Frameo

ImmichFrame can be run on inexpensive Frameo digital photo frames with some additional effort. You can typically find these for ~$40 USD. These devices are low powered and run a very old Android version, so they cannot run the full WebView version of the app (however most of the main features are still supported except SplitView). We have found a method to update the WebView, but it is not without risks, see Frameo Webview Update below.
If you have not already, you will need to install ADB on your PC (ADB instructions). ADB is often enabled on these devices by default, if it is not go to Frameo Settings-About-Enable Beta Program. Toggle ADB Access On-Off-On. Use the ADB commands below to sideload ImmichFrame APK, configure it to your liking, then disable the Frameo app to to set ImmichFrame as default Home app:

• Sideload ImmichFrame: adb install /path/to/ImmichFrame_vXX.apk
• Update existing ImmichFrame: adb install -r /path/to/ImmichFrame_vXX.apk
• Start ImmichFrame: adb shell am start com.immichframe.immichframe/.MainActivity
  • Swipe down to enter ImmichFrame Settings
  • Configure URL and Authorization Secret (optional)
  • Disable WebView
• Set as default HOME app
  • On first reboot after install you will be asked to select default Launcher, select ImmichFrame
  • Alternatively you can disable Frameo
    • adb shell su
    • pm disable net.frameo.frame
    • exit
    • If this doesn't stick on reboot, repeat the commands but power cycle after exit command
• Some other useful ADB commands:
  • Reboot: adb reboot
    • You can also reboot or shutdown by holding down power button
  • Access Android Settings: adb shell am start -a android.settings.SETTINGS
  • Re-enable Frameo: repeat disable commands above but replace "disable" with "enable"
  • Start Frameo app: adb shell am start net.frameo.frame
  • Uninstall ImmichFrame: adb uninstall com.immichframe.immichframe

Frameo WebView Update

Follow instructions below to update WebView to 106. This has been tested and working on Android 6.01 10.1" Frameo devices:

Download WebView 106 to PC:

Lineage OS WebView 106-0-5249-126-12

Push new apk to sdcard

adb push /path/to/your/new/webview.apk /sdcard/

Enter root shell

adb shell su

Backup original WebView APK

mount -o rw,remount /system && cp /system/app/webview/webview.apk /system/app/webview/webview.apk.bak

Delete the oat folder recursively

mount -o rw,remount /system && rm -rf /system/app/webview/oat

Copy new WebView to system

mount -o rw,remount /system && cp /sdcard/webview.apk /system/app/webview/webview.apk

exit root

exit

Reboot device

adb reboot

Desktop (Windows, MacOS, Linux)

Get the latest Desktop-App from the GitHub Releases-Page.

The screen is configured in a 3x3 gird. You can touch or click:

-	Settings	-
Prev image	Pause	Next image
-	Quit	-

MacOS

• Open DMG, drag immichframe.app to applications folder.
• If you get an error that it is "damaged and can't be opened, you should move it to the trash" run xattr -c /Applications/immichframe.app in terminal.

Keyboard:

Settings - Up arrow
Quit - Down arrow
Prev Image - Left arrow
Next Image - Right arrow
Pause - Enter/Return