Metadata-Version: 2.4
Name: mobilerun-viewer
Version: 0.1.0
Summary: Native desktop viewer for Mobilerun cloud devices — live WebRTC stream, system nav buttons, and an action event panel.
Project-URL: Homepage, https://github.com/droidrun/mobilerun-viewer
Project-URL: Issues, https://github.com/droidrun/mobilerun-viewer/issues
Author: Mobilerun
License: MIT
Keywords: android,automation,mobilerun,viewer,webrtc
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: MacOS X :: Cocoa
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Testing
Requires-Python: <3.14,>=3.11
Requires-Dist: click>=8.0
Requires-Dist: httpx>=0.27
Requires-Dist: platformdirs>=4.0
Requires-Dist: pywebview>=5.0
Requires-Dist: websockets>=14
Description-Content-Type: text/markdown

# mobilerun-viewer

Native desktop viewer for [Mobilerun](https://mobilerun.ai) cloud devices.
Renders the live WebRTC stream of a cloud-hosted phone in a desktop window
with system nav buttons (BACK / HOME / RECENTS) and a side panel that
shows every tool call (tap, swipe, press, …) in real time.

Reuses the same credential as the `mobilerun` CLI — read from
`MOBILERUN_API_KEY` or the file `mobilerun login` writes — so authenticating
in either command works for both.

## Install

```bash
uv tool install mobilerun-viewer
# or:
pip install mobilerun-viewer
```

## Use

```bash
# Discover your devices via the main CLI:
mobilerun devices --cloud

# Open the viewer:
mobilerun-viewer -d <device-id>

# Against a non-default API base (dev / staging):
mobilerun-viewer -d <device-id> --base-url https://dev-api.mobilerun.ai/v1

# Track an agent's task trajectory in the events panel:
mobilerun-viewer -d <device-id> --task-id <task-id>
```

If the main `mobilerun` CLI is installed alongside this package, the same
viewer is also reachable as `mobilerun stream …`.

## Flags

- `-d, --device-id` (required) — cloud device id.
- `--base-url` — Mobilerun API base; default `https://api.mobilerun.ai/v1`.
- `--task-id` — task whose trajectory feeds the events panel. Defaults to
  the device's `activeTaskId` if one is running.
- `--no-window` — don't open a desktop window; just print the local
  viewer URL (useful for debugging).
