Snap-O is a handy macOS app for inspecting Android apps. Capture screenshots and recordings, inspect network traffic, override responses, and adjust app values while your app runs.

Documentation

Get started

Requires macOS 15 or later and adb from Android Platform Tools.

If you don't already have adb, install Android Platform Tools through Android Studio or brew install android-platform-tools.

1. Download Snap-O and move it to Applications.
2. Connect a device with USB debugging enabled, or start an emulator.
3. Open Snap-O. Live Preview starts automatically. Option-drag the preview to share a screenshot, or press ⇧⌘R to record.

Screen capture needs no library in your Android app. Network Inspector and Tweaks each require an Android integration; follow the guides below.

For keyboard shortcuts and ADB setup, see Using the macOS app.

Screen capture

Drag screenshots and recordings straight into a pull request, chat, or document without saving them first. Play recordings immediately and step through them frame by frame to check an animation. Work with multiple devices and keep captures open in separate windows.

Network Inspector

Inspect HTTP requests and responses, JSON bodies, Server-Sent Events, and WebSocket messages. Snap-O buffers recent traffic on the device, so you can inspect requests made before you opened the inspector.

The Android libraries support OkHttp, Ktor's OkHttp engine, and HttpURLConnection. Python handlers can edit or mock HTTP responses through the app's OkHttp connection.

Set up Network Inspector

Tweaks (Alpha)

Change values in Compose, Views, and other Kotlin code without rebuilding or restarting your app. Adjust numbers, colors, booleans, strings, enums, and Bézier curves, or run actions registered by the app.

Use tweaks-core and TweakScope outside Compose. See Tweaks without Compose for setup and ownership examples.

Tweaks are available through App Inspector, an optional on-device panel, the CLI, and the REST API. This feature is in alpha; its APIs and behavior may change.

Set up Tweaks

CLI and Codex

The snapo CLI supports network inspection, Python response overrides, and Tweaks on macOS and Linux. It requires Python 3 and Android Platform Tools and can run independently of the macOS app.

On macOS, the app includes the CLI:

/Applications/Snap-O.app/Contents/MacOS/snapo network list --json

The Codex plugin bundles the CLI with skills for network inspection and Tweaks:

codex plugin marketplace add openai/snap-o --ref main
codex plugin add snap-o@snap-o

Start a new Codex session after installation.

CLI setup and commands · Linux installation · Plugin updates

Build from source

Requires Xcode 26 or later, Node.js 22.12 or later, and Android Platform Tools.

1. Clone this repository.
2. Ensure npm is available to Xcode.
3. Open snapo-app-mac/Snap-O.xcodeproj in Xcode, then build and run.

See Contributing for development and signing instructions, and Release requirements for release checks.

Contributing

Snap-O is maintained as time allows, with no formal roadmap. Bug reports and small patches are welcome. Read the contribution guide and code of conduct before contributing.

License

Apache 2.0. Copyright 2025 OpenAI.