openclaw/850media/frameo

Frameo Digital Photo Frame Control

Control Frameo photo frames via cloud API or ADB.

Methods

Method 1: Cloud API (Limited)

• ✅ List paired frames
• ✅ Get account info
• ❌ Send photos (requires FCM/Firebase)

Method 2: ADB (Full Control)

• ✅ Push photos directly
• ✅ Control brightness
• ✅ Toggle screen
• ✅ Navigate photos

Quick Start

Cloud API Setup

1. Install: pip3 install requests pillow
2. Get Bearer token from Frameo app traffic (Proxyman/Charles)
3. Save token: echo '{"access_token": "YOUR_TOKEN"}' > ~/.frameo_token
4. Run: python3 scripts/frameo_client.py --frames

ADB Setup (Recommended)

1. Enable Developer Options on Frameo (Settings → About → tap Build 7x)
2. Enable USB Debugging
3. Connect USB-C data cable to computer
4. Run: adb tcpip 5555 to enable wireless
5. Disconnect USB, connect wireless: adb connect <frame-ip>:5555

Usage Examples

List Frames (Cloud API)

python3 scripts/frameo_client.py --frames

Send Photo (ADB)

adb push photo.jpg /sdcard/DCIM/
# Or to Frameo's photo directory:
adb push photo.jpg /sdcard/Frameo/

Control Frame (ADB)

# Screen on/off
adb shell input keyevent 26

# Set brightness (0-255)
adb shell settings put system screen_brightness 128

# Next photo (swipe right)
adb shell input swipe 800 500 200 500

# Previous photo (swipe left)  
adb shell input swipe 200 500 800 500

Remote Access via SSH Relay

If frame is on local network and agent is remote:

ssh user@local-mac "adb push /tmp/photo.jpg /sdcard/DCIM/"

References

• references/api-endpoints.md - Frameo cloud API endpoints
• references/adb-commands.md - Common ADB commands for Frameo

Troubleshooting

Token Expired (401)

Frameo tokens expire in ~5 minutes. Get fresh token from Proxyman.

ADB Connection Refused

Wireless ADB not enabled. Need USB cable first to run adb tcpip 5555.

USB Cable Not Detected

Ensure using a data cable, not charge-only. Data cables are usually thicker.