wesbos/photo-frame-dashboard

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/wesbos/photo-frame-dashboard.svg?style=card)](https://bestofgithub.dev/repo/wesbos/photo-frame-dashboard)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/wesbos/photo-frame-dashboard.svg)](https://bestofgithub.dev/repo/wesbos/photo-frame-dashboard)

Loading README…

Phase	What to read
1. Identify the hardware	USB IDs (Rockchip is VID `2207`), `adb shell getprop`, chip query in loader mode. See the hardware tables in biuframe.md and hardware-research.md.
2. Get ADB	Try in this order: (1) over USB (`adb devices`; accept any "Allow USB debugging" prompt on the screen), (2) over the network (`adb connect <ip>:5555`), (3) only then a vendor-app trick or a boot patch. The PF1007L boot patch is written from an SD card, see pf1007l-start-here.md. Ideally no one needs (3). For a vendor-app trick, decompile the vendor app (jadx) and look for hidden tap counters and code dialogs: app-analysis.md. Gestures that did not work are in research-log.md.
3. Loader mode	Skylight: hold Volume − while connecting power. BIUFRAME: reset button at power-on (unconfirmed). Building `rkdeveloptool` on Apple silicon: research-log.md.
4. Back up	If loader reads past 32 MiB return `0xCC` filler, they are not a backup: loader-research.md. Patched helper and full capture: `scripts/patch-usb-reader.py`, `scripts/load-usb-reader.py`, `scripts/probe-reader.py`, `scripts/backup-flash.py`, `scripts/inspect-backup.py`. With root, back up over ADB instead: `scripts/biuframe-setup.sh backup`.
5. Root	First check for a shipped `su` (`adb shell su -c id`). On Android 10+ user builds, try the debug-ramdisk route: debug-ramdisk-research.md, `scripts/build-debug-boot.py`. Fastboot write failures: ram-boot-research.md.
6. Make it useful	Launcher: android-launcher.md. Old Android (6.x) with a browser, WebView swap, CA roots, swap, nav bar and disabling vendor apps: biuframe-setup-guide.md. Kiosk app and launcher database edits: biuframe.md. A working example of a kiosk app and dashboard is in `dashboard/`. Build with `dashboard/kiosk/build.sh` (macOS/Linux) or `dashboard/kiosk/build.ps1` (Windows), change `DEFAULT_URL` in `MainActivity.java` to your own URL, and target the device's WebView version (see `dashboard/vite.config.js`).
7. Networking	USB reverse tethering with gnirehtet: usb-internet-sharing.md. An app that requires Wi-Fi specifically: onboarding-network-gate.md. Dead onboard Wi-Fi and a USB dongle: usb-wifi-dongle.md.
8. Vendor updates	Connecting the stock app to the internet can auto-install APK updates: app-updates.md. Disable vendor updaters (FOTA etc.) before going online.
9. Security hand-off	Tell the owner what they now have: biuframe-setup-guide.md.

wesbos/photo-frame-dashboard

Taking over Android photo frames

Working frames

Community builds

Which frame do you have?

The dashboard

For agents: start here

Rules we learned the hard way

Check for updates, and send back what you find

Keep a private record of each frame

Phase map

Other docs

Privacy