Frameo Frames

Note

Frameo devices tend to be low-powered with limited resources. It is recommended to disable any image effects and depending on your device you may need to enable optimize_images.

Prerequisites

• adb downloaded and installed
• ADB access enabled on the frame: Settings -> About -> Enable Beta Program
• A USB-C to USB-A cable may be needed - some frames do not have TCP/IP enabled by default

Connecting via USB

Tip

Some Frameo frames only allow one ADB connection at a time. If connecting multiple devices, each will need to go through this process.

Tip

Some devices require a high-current USB-C cable and a USB port capable of supplying sufficient power, not just data.

This is because the USB-C connection is used for both data transfer and power delivery. If the port cannot provide enough power, the device may not function correctly.

1. Connect the Frameo frame to your computer via USB

2. List connected devices:

   adb devices

3. If the device shows as unauthorized, go to Settings -> About -> Enable Beta Program on the frame and toggle it off and back on. A reboot may also be needed.

4. Optional: Once the device shows as device, enable TCP/IP for wireless ADB:

   adb tcpip 5555

Connecting wirelessly

Once TCP/IP is enabled (see above), you can connect without USB:

adb connect <device_ip>:5555

Caution

Network ADB resets after reboot. You will need to re-enable it via USB after each restart, or use a tool like Tasker to automate this.

Making ADB persistent (optional)

If you want ADB to survive reboots without needing to toggle Beta Program each time:

# Set persistent USB configuration for ADB
adb shell "setprop persist.sys.usb.config adb"

# Ensure ADB and developer settings stay enabled
adb shell "settings put global adb_enabled 1"
adb shell "settings put global development_settings_enabled 1"

Verify it worked:

adb shell getprop persist.sys.usb.config
# Should output: adb

Test after reboot:

adb reboot
# Wait for device to fully boot (30-60 seconds)
adb devices

---

Updating the system WebView

Danger

Not all Frameo devices are the same, hardware and software versions may differ and these steps may not work for every device. Proceed at your own risk. We accept no responsibility for any damage or issues that may result.

Caution

Check your current WebView version before proceeding:

adb shell dumpsys webviewupdate

If you have WebView v101 or newer, skip this section - your device is already compatible.

Tip

The WebView APK path may vary by device. To find it:

adb shell pm path com.android.webview

Older Frameo devices ship with a system WebView that is not compatible with Kiosk. To update it:

1. Download the 106 WebView apk from here

2. Connect to your device with ADB (see connection options above - USB or network)

3. Push the WebView apk to the device

   adb push path/to/downloaded/webview.apk /sdcard/

4. Enter root

   adb shell su

5. Backup the original WebView apk

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

6. Remove the existing WebView oat files

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

7. Copy the new WebView apk to the device

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

8. Exit root

   exit

9. Reboot the device

   adb reboot

Acknowledgement

A big thank you to Rob. This guide wouldn’t be possible without his help!

Alternative webview guide

If you encounter issues updating the webview on 6.0.1 devices, an alterntive method and troubleshooting can be found here

---

Displaying Kiosk on your Frameo

Choose one of the apps below - you do not need to install both.

Fully Kiosk Browser

Tip

Setting sleep_dim_screen=true will automatically dim the screen when the device enters sleep mode.

1. Download the latest Fully Kiosk Browser APK from here

2. Install it:

   adb install path/to/downloaded/Fully-Kiosk-Browser.apk

3. Launch it:

   db shell am start -n de.ozerov.fully/.MainActivity

ImmichFrame

Tip

Setting sleep_dim_screen=true will automatically dim the screen when the device enters sleep mode.

Although Kiosk doesn’t have its own Android app, the ImmichFrame team has built a native Android app that works with Kiosk.

Note

ImmichFrame has an option to set an auth secret in its settings. This is passed to Kiosk as the password.

1. Download the latest ImmichFrame APK from here

2. Install it:

   adb install path/to/downloaded/immichframe.apk

3. Launch it and configure your Kiosk server URL:

   adb shell am start -n com.immichframe.immichframe/.MainActivity

Uninstalling ImmichFrame

1. Uninstall the app:

   adb uninstall com.immichframe.immichframe

2. Re-enable the Frameo app:

   pm enable net.frameo.frame

---

Disable the Frameo app

Without root (Android 8+)

adb shell pm disable-user --user 0 net.frameo.frame

With root (Android 6/7)

1. Enter root:

   adb shell su

2. Disable the Frameo app:

   pm disable net.frameo.frame

3. Exit root:

   exit

---

Troubleshooting

Device loses WiFi after disabling the Frameo app

The Frameo setup wizard configures WiFi within the Frameo app only - not in Android system settings. When the Frameo app is disabled, that WiFi config is no longer active.

Fix: Before disabling the Frameo app, connect to your WiFi network via Android system settings (Network & Internet -> WiFi), not through the Frameo wizard.

If you have already disabled the Frameo app and lost connectivity:

1. Re-enable the Frameo app:

   adb shell pm enable net.frameo.frame

2. Open Android WiFi settings and connect to your network

3. Disable the Frameo app again once connectivity is confirmed

ADB shows “unauthorized”

Go to Settings -> About -> Enable Beta Program on the frame and toggle it off and back on. Accept the authorisation prompt on the device screen, then retry:

adb devices

ImmichFrame not launching on boot

Set it as the default home launcher:

adb shell cmd package set-home-activity com.immichframe.immichframe/.MainActivity

Restoring the original Frameo experience

# Re-enable the Frameo app
adb shell pm enable net.frameo.frame

# Set it as default launcher
adb shell cmd package set-home-activity net.frameo.frame/.MainActivity

# Optionally uninstall ImmichFrame
adb uninstall com.immichframe.immichframe

Tested devices

The following devices have been tested by the community. This list is not exhaustive - if you have a device that works (or doesn’t), please add it.

Model	Android version	WebView version	Root required	Notes
Yenock ZN-DP1101	13	v101.0.4951.61	No	No WebView update needed
Denver FFP-1037W	6.0.1	v44.0.2403.119	Yes	WebView update succsesful
Moonka ZN-DP1101	13	v106.0.5249.126	No	No WebView update needed