Install i99op
The standalone binary, installing from source, and the optional desktop GUI.
Prerequisites
| Tool | Needed for | Notes |
|---|---|---|
adb | connect, shell, exec | On your PATH, or in a standard Android SDK location. The recover flow uses the text channel and needs no adb. |
| Python ≥ 3.10 | install-from-source only | Not needed for the standalone binary. |
Install
The simplest path — no Python required. Download the build for your OS
(Linux / macOS / Windows) from the
i99dash download page, put it on your
PATH, and run:
i99op --helpKeep it current with the built-in self-update, which pulls the latest build from the same place:
i99op upgradepipx install . # from a checkout of the operator-cli repo
# or: pip install .
i99op --helppipx keeps i99op in its own isolated environment and on your PATH.
Prefer a window to a terminal? Install the GUI extra and launch the full graphical client (Session, Tickets, Device, Apps, Files, Screen, Logcat):
pip install '.[gui]' # PySide6 + qasync
i99op guiA standalone GUI binary (i99op-gui-*, no Python) is published alongside
the CLI on the download page. See
Run a session.
Configuration
i99op stores its config under ~/.config/i99op (or %APPDATA%\i99op on
Windows). The default backend is https://i99op.i99dash.app.
| Override | How |
|---|---|
| Backend URL | i99op login --base <url>, or the I99OP_BASE env var (a saved base wins over the built-in default). |
| Token | Stored in the OS keyring when keyring is installed (pip install 'i99op[keyring]'), otherwise a 0600 config file. I99OP_TOKEN overrides. |
Inspect the current state any time:
i99op configVerify
i99op version
i99op --helpBoth should print without errors. Next: sign in.