Maestro/docs/remote-access.md

title

title
Remote Access

Maestro includes a built-in web server for mobile remote control:

1. Automatic Security: Web server runs on a random port with an auto-generated security token embedded in the URL
2. QR Code Access: Scan a QR code to connect instantly from your phone
3. Global Access: All sessions are accessible when the web interface is enabled - the security token protects access
4. Remote Tunneling: Access Maestro from anywhere via Cloudflare tunnel (requires cloudflared CLI)

Mobile Web Interface

The mobile web interface provides:

• Real-time session monitoring and command input
• Device color scheme preference support (light/dark mode)
• Connection status indicator with automatic reconnection
• Offline queue for commands typed while disconnected
• Swipe gestures for common actions
• Quick actions menu for the send button

Local Access (Same Network)

1. Click the "OFFLINE" button in the header to enable the web interface
2. The button changes to "LIVE" and shows a QR code overlay
3. Scan the QR code or copy the secure URL to access from your phone on the same network

Remote Access (Outside Your Network)

To access Maestro from outside your local network (e.g., on mobile data or from another location):

1. Install cloudflared: brew install cloudflared (macOS) or download for other platforms
2. Enable the web interface (OFFLINE → LIVE)
3. Toggle "Remote Access" in the Live overlay
4. A secure Cloudflare tunnel URL will be generated
5. Use the Local/Remote pill selector to switch between QR codes
6. The tunnel stays active as long as Maestro is running - no time limits, no account required

Screenshots