Turning a Frameo photo frame into an Immich slideshow
Swap a cheap Frameo frame's spyware app for ImmichFrame, showing photos from your own Immich on StartOS.
This guide walks through one specific frame, the VESWWE 10.1" sold as DP100, but most Frameo frames follow the same pattern. Two things catch people out: the frame won't power up from a USB-C-to-C cable, and the box says DP100 while the board inside may be a DP101. Check which one you have before you change anything.
How the frame reaches your server
The frame opens your server's own https LAN address, e.g. https://192.168.1.20:61959, encrypted on your network, with no domain and no VPS involved. That address is signed by your server's private Root CA, so the frame has to trust it.
On any Android 7 or later device, the ImmichFrame Android app ignores a Root CA installed from Android's settings, even though browsers accept it, so the usual way of trusting it doesn't help. This frame has another way: its adb shell runs as root, so your Root CA can go straight into Android's system certificate store, which every app trusts. Step 6 does that.
The frame can't look up .local names, so it uses your server's IP address. Give your server a fixed address with a DHCP reservation on your router.
Two other routes exist, for cases this one doesn't cover:
| Root CA route (this guide) | Domain route | Plain http route |
|
|---|---|---|---|
| When to use it | A frame at home whose adb shell is root |
A frame outside your home network | A frame without root adb, at home |
| Frame's address | https://192.168.1.20:61959 |
https://frame.example.com |
http://192.168.1.20:61995 |
| Encrypted | Yes | Yes, end to end | No: photos and the access secret cross your network in the clear |
| What it needs | Your server's Root CA on the frame | A public domain with a Let's Encrypt certificate | Marking a gateway secure in StartOS, a server-wide switch |
The steps follow the Root CA route. Step 2 notes where the other two differ.
Before you start
- Immich on StartOS at
3.3.3:1or later. Earlier versions can't hand out access keys to other services. - ImmichFrame on StartOS,
1.0.39.0:6or later, from the StuPleb registry (https://startos.stupleb.xyz). It needs StartOS 0.4.1 or later. - A fixed LAN address for your server, from a DHCP reservation on your router.
- Only on the other routes: a public domain you can point at ImmichFrame, e.g.
frame.example.com, for the domain route, or SSH access to your server for the plainhttproute. - A computer with ADB. On a Mac,
brew install --cask android-platform-tools. On Windows or Linux, install Google's Android SDK Platform-Tools. - A USB-A to USB-C cable that carries data, plus a USB-C-to-A adapter if your computer only has USB-C ports.
Quick step: Trusting StuPleb packages (StartOS 0.4.1+)
- Go to System → Trusted keyrings → Add.
- Name it StuPleb and paste this into Public keys:
-----BEGIN PUBLIC KEY-----
MCowBQYDK2VwAyEAs1XnEDvdjbTOcFvq5UK+SPLkbWu9Mbe4yFF8BtiWYvQ=
-----END PUBLIC KEY-----
- Save. StuPleb packages can now be installed from the Marketplace.
1. Set up ImmichFrame on StartOS
Install ImmichFrame and run its Manage Slideshows task. Keep Private, and pick your Time Zone if you'll show calendars. The Access Secret and Admin Password are filled in for you: copy both now, or come back to Manage Slideshows for them later. Submit.
Run Connect Immich. You can enter the Immich Account Email of the account to show, which Immich displays with the request. Then open Immich's Tasks, approve ImmichFrame's request and choose that account. Back on ImmichFrame, the Immich Access health check should say Immich accepts every connected account's key within a few seconds.
You'll need the access secret in step 8.
2. Get the frame's address and your Root CA
On ImmichFrame's Slideshow interface, copy the address that starts with https:// and your server's LAN IP, e.g. https://192.168.1.20:61959. That's the frame's address.
Then open your server's plain http address, e.g. http://192.168.1.20, in a browser on your computer, and save the Root CA it offers to your Downloads folder. Step 6 puts it on the frame.
On the domain route instead
Add your domain to ImmichFrame's Slideshow interface and let it get its certificate. Then open https://frame.example.com/ on a phone with Wi-Fi off. It should ask for the access secret and not show photos. That's correct. Skip step 6.
A domain on Slideshow also serves the Admin page at /admin, behind the admin password. That's normal for StartOS packages (Ghost's /ghost works the same way), but it's worth knowing.
On the plain http route instead
StartOS only offers plain http addresses on a gateway you've marked secure. SSH into your server, find your home LAN's gateway, and mark it:
start-cli net gateway list
start-cli net gateway set-secure <GATEWAY>
ImmichFrame's Slideshow interface now lists an http:// address with your server's IP and a port. That's the frame's address. Skip step 6.
Know what you're switching on. It's one switch for the whole server: every installed service with a plain http address gains it on your LAN at once, and the access secret and your photos cross your network unencrypted. Only do it if you control every device on that network. start-cli net gateway unset-secure <GATEWAY> turns it off again.
3. Power the frame from your computer
The frame has a single USB-C port for both power and data, and no battery. Connect it to your computer with the USB-A to USB-C cable, through an adapter if needed.
A USB-C-to-C cable leaves it dark, even a good one. The frame doesn't ask a USB-C source for power, so your computer never switches it on. A USB-A socket always supplies power, which is why the adapter route works.
4. Turn on ADB
On the frame, open Frameo's Settings → About → Beta Program and switch on ADB Access.
Then on your computer:
adb devices -l
If the frame shows as unauthorized, tick Always allow on the prompt on the frame's screen and run the command again. You want to see device.
5. Check which frame you have
Run these one at a time. They only read:
adb -d shell getprop ro.product.model
adb -d shell getprop ro.build.version.release
adb -d shell getprop ro.board.platform
adb -d shell getprop ro.product.cpu.abi
adb -d shell getprop ro.build.display.id
| Check | This guide expects |
|---|---|
| Model | DP101 |
| Android | 10 |
| Platform | ceres |
| ABI | armeabi-v7a |
| Build | DP101_Frameo_V02_26061607 |
If your model says DP100, you have the older board (Android 8.1, Rockchip), and some of what follows doesn't apply. Stop and look at the DP100 notes instead. The same listing ships both.
6. Install your Root CA
First check that the frame's adb shell runs as root. This should print uid=0(root):
adb -d shell id
If it doesn't, the Root CA route isn't open on your frame: go back to step 2 and use the domain route, or plain http.
Android looks certificates up by a short hash of their name. Print yours, using the name of the file you saved:
openssl x509 -in ~/Downloads/your-server.crt -noout -subject_hash_old
It prints eight characters, e.g. 18c59ccf. Copy the certificate onto the frame:
adb -d push ~/Downloads/your-server.crt /data/local/tmp/ca.crt
Then add it to the system store, with your eight characters in place of each <HASH>. This briefly makes the system partition writable, copies the file in with the same permissions as the certificates already there, and makes it read-only again:
adb -d shell 'mount -o remount,rw / && cp /data/local/tmp/ca.crt /system/etc/security/cacerts/<HASH>.0 && chmod 644 /system/etc/security/cacerts/<HASH>.0 && chcon u:object_r:system_security_cacerts_file:s0 /system/etc/security/cacerts/<HASH>.0; mount -o remount,ro /'
It survives reboots, and should survive a factory reset too, since that only wipes apps and their data. If ImmichFrame is already running, restart it with the two commands in step 9.
7. Install the ImmichFrame app
Download the latest release from ImmichFrame_Android. At the time of writing it's v50:
curl -L -o ~/Downloads/ImmichFrame_v50.apk https://github.com/immichFrame/ImmichFrame_Android/releases/download/v50/ImmichFrame_v50.apk
shasum -a 256 ~/Downloads/ImmichFrame_v50.apk
The hash should be 625a93bdedec16c4733eb7b1ca4ba3ef394431cd0ed706018661803f14c60f86. Then install it and start it:
adb -d install ~/Downloads/ImmichFrame_v50.apk
adb -d shell am start -n com.immichframe.immichframe/.MainActivity
The frame shows ImmichFrame's settings.
8. Configure the app
- Server URL: the address from step 2, with no path, e.g.
https://192.168.1.20:61959. - Authentication secret: the Access Secret from Manage Slideshows.
- WebView: leave it on. This frame's WebView (113) is new enough, and it gets you HEIC photos, SplitView and the richer layout.
Typing 32 characters on the touchscreen is tedious. Tap the secret field, then type it from your computer:
adb -d shell input text 'YOURSECRET'
Save. Photos should appear. Swiping down opens the settings again.
9. Fix the clock
ImmichFrame defaults to a 12-hour clock with no AM/PM, so 18:00 shows as 06:00. Open ImmichFrame's Admin interface, sign in with the Admin Password from Manage Slideshows, set Clock format to HH:mm and save. Then restart the app:
adb -d shell am force-stop com.immichframe.immichframe
adb -d shell am start -n com.immichframe.immichframe/.MainActivity
10. Make ImmichFrame the home screen
First make sure you can still reach Android's settings, because the frame has no Back or Home buttons:
adb -d shell am start -a android.settings.SETTINGS
Bring ImmichFrame back, then set it as home:
adb -d shell am start -n com.immichframe.immichframe/.MainActivity
adb -d shell cmd package set-home-activity --user 0 com.immichframe.immichframe/.MainActivity
Check it took. This should print com.immichframe.immichframe/.MainActivity:
adb -d shell cmd package resolve-activity --brief -a android.intent.action.MAIN -c android.intent.category.HOME
Only then, disable Frameo and remove the Adups updater. Disabling Adups alone doesn't stop it, so it has to be removed for the user too:
adb -d shell pm disable-user --user 0 net.frameo.frame
adb -d shell pm disable-user --user 0 com.adups.fota
adb -d shell pm uninstall -k --user 0 com.adups.fota
Frameo 1.29 and later is said to block ImmichFrame as the home app. That doesn't matter on this route: Android's own command sets home, and Frameo is disabled.
11. Confirm it survives a reboot
adb -d reboot
After a minute you should see the slideshow, not Frameo. The frame can go on its own power supply now.
12. Optional: fix washed-out, blue colours
The frame's Allwinner chip has a colour engine that ships switched off. These settings are saved on the frame and applied at every boot:
adb -d shell 'setprop persist.display.enhance_mode 1; setprop persist.display.HSL_saturation 65; setprop persist.display.color_temperature 30'
adb -d reboot
Tune the numbers to taste. Raising saturation makes colours richer, and raising colour temperature makes the picture warmer.
A second frame with different photos
Each frame can show its own photos. In Manage Slideshows, add a slideshow, name it, e.g. Kitchen, tick the Immich accounts it shows, and submit. It gets its own Slideshow (Kitchen) and Admin (Kitchen) interfaces, with their own address, access secret and admin password, and your first frame keeps running. Set the second frame up as above with that slideshow's address and secret, and choose its photos on Admin (Kitchen).
When you connect another Immich account, tick the slideshows that show it under Show on. On the domain route, each slideshow needs a domain of its own.
Showing a shared album
Put the album's ID (the part of its Immich address after /albums/) into Admin → Accounts → Albums.
A shared album only shows the photos of the account you set it on, not the ones other people added. To show everyone's, run Connect Immich once per person, approve each with their account, and give each account the same album ID.
Undoing it
adb -d shell pm enable net.frameo.frame
adb -d shell cmd package set-home-activity --user 0 net.frameo.frame/.ui.activities.AWaitForDeferredInitCompleted
adb -d shell cmd package install-existing com.adups.fota
adb -d shell pm enable com.adups.fota
adb -d uninstall com.immichframe.immichframe
For the Root CA, with your eight characters in place of <HASH>:
adb -d shell 'mount -o remount,rw / && rm /system/etc/security/cacerts/<HASH>.0; mount -o remount,ro /'
For the colours:
adb -d shell 'setprop persist.display.enhance_mode 0; setprop persist.display.HSL_saturation 50; setprop persist.display.color_temperature 0'
Keeping the frame off the internet with StartWRT
The frame runs Android 10 with no security updates since 2023, plus factory apps nobody has audited. It only needs to reach your server, and a time server for its clock. On StartWRT, that's a Security Profile of its own.
Point the frame's clock at Cloudflare. Android normally syncs time from servers whose addresses change, which a whitelist can't follow, so switch it to one you can list:
adb -d shell settings put global ntp_server time.cloudflare.com
On the domain route only, find the address your domain points to:
adb -d shell ping -c 1 frame.example.com
If you use StartTunnel, this is your VPS. If you publish ImmichFrame through the router itself, it's your router's public address.
Create the profile: in StartWRT, go to Security Profiles → Add and name it, e.g. Photo frames.
| Setting | Root CA or plain http route |
Domain route |
|---|---|---|
| LAN → Access | Whitelist, with your server's profile, so the frame can reach it | Same profile, so the frame can't see your other devices |
| WAN / Internet → WAN Access | Whitelist: 162.159.200.1, 162.159.200.123 only |
Whitelist: the address from above, plus 162.159.200.1, 162.159.200.123 |
| DNS | Inherit from system | Inherit from system |
The two 162.159.200.x addresses are Cloudflare's time servers. On the Root CA and plain http routes, the whitelist lets the frame reach every device on your server's profile, not just the server, so keep that profile for devices you trust.
Give it a Wi-Fi password: go to Points of Entry → Wi-Fi → Passwords → Add, generate a password and map it to Photo frames.
Move the frame onto the new password. Plug it into your computer again, open Wi-Fi settings, forget your network, and rejoin with the frame's password:
adb -d shell am start -a android.settings.WIFI_SETTINGS
Confirm it worked. This should fail:
adb -d shell ping -c 2 8.8.8.8
The slideshow should keep loading new photos.
On the domain route, if you ever move StartTunnel to a new VPS, the address changes and the whitelist needs the new one. Otherwise the frame goes blank.
2026-11-14