frameo

name	frameo
description	Control Frameo digital photo frames. Use when: sending photos to Frameo frames, listing paired frames, controlling frame via ADB (brightness, screen, navigation). Supports both cloud API (read-only) and ADB (full control including photo upload). Requires either Frameo account credentials or ADB access to the frame.

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.