Frameo Frames

Note

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

If you have a Frameo frame device and want to use Kiosk on it, follow these steps:

Prerequisites

• Have adb downloaded/installed.
• Have ADB Access enabled in the Frameo Settings->About->Enable Beta Program.
• (Might need) USB-C to USB-A cable to connect your frameo frame to your computer.
  • Some frames do not have tcpip enabled on the frame by default so a USB connection might be needed.

Connecting to the Frameo Frame through USB

Tip

Some Frameo frames only allow one device to connect to it. Otherwise, this process needs to be done by each device connecting to the frame.

Caution

Once rebooted, the device will lose these settings. In order to keep the settings and enable connecting remotely, you will need to use a program like Tasker to restore ADB each reboot.

1. Connect USB-C cable from the Frameo Frame to computer through a USB-A port
2. On the computer list devices

   adb devices

3. If the list of devices has Unauthorized next to it then you will need to go to Settings->About->Enable Beta Program. and toggle it back and forth a. A reboot might be needed as well
4. The list of devices should show device next to the frame that is attached via USB. If that isn’t the case, then go back to step 3.
5. Enable tcpip on the frame

   adb tcpip 55555

6. You can now continue with the steps below

Updating the system WebView

Caution

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

Acknowledgement

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

Tip

The location of the WebView APK may vary depending on your device or Android version. To find its path, use:

adb shell pm path com.android.webview

Frameo frame device normally come with a very old system WebView that is not compatible with Kiosk. To update the WebView, follow these steps:

1. Download the 106 WebView apk from here

2. Connect to your device with adb

   adb connect <device_ip>:5555

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

Displaying Kiosk on your Frameo

Below are the two most common apps used to display the Kiosk on Frameos. Please note that you do not need to install both apps.

Fully Kiosk Browser

Installing 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. Connect to your device with adb

   adb connect <device_ip>:5555

3. Install the Fully Kiosk Browser apk

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

4. Start the Fully Kiosk Browser app

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

ImmichFrame

Installing 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 dedicated Android app, the ImmichFrame team has developed a native Android application that’s compatible with Kiosk.

Note

The ImmicFrame app has an option to set an authsecret in the settings. This will be passed along to Kiosk as the password.

1. Download the latest ImmichFrame apk from here

2. Connect to your device with adb

   adb connect <device_ip>:5555

3. Install the ImmichFrame apk

   adb install path/to/downloaded/immichframe.apk

Uninstall ImmichFrame

1. Connect to your device with adb

   adb connect <device_ip>:5555

2. Uninstall the ImmichFrame app

   adb uninstall com.immichframe.immichframe

3. Enable the Frameo app

   pm enable net.frameo.frame

Disable Frameo app

1. Connect to your device with adb

   adb connect <device_ip>:5555

2. Enter root

   adb shell su

3. Disable the Frameo app

   pm disable net.frameo.frame

4. Exit root

   exit