KnifeLemon / Droidline

Automate real Android phones from your code. 
 Test your apps, script the tasks you repeat, run a shelf of phones, or let an AI agent use one. 
 Python, Node.js, the shell or HTTP. No ADB, no USB cable, no root.
 Website ·
 Docs ·
 Download ·
 Sponsor ·
 Quick start ·
 Languages ·
 Guides 
 English · 한국어 · 简体中文 
 No ADB, no cable Install one app on the phone, turn on its permissions and pair it with a QR code. No developer options, no USB debugging, no root. 
 The same command everywhere touch is touch in Python, Node.js, the CLI, HTTP and as an MCP tool, all generated from one spec. 
 Phones anywhere The phone connects out to your PC, so it works on the same Wi-Fi or on mobile data through a tunnel or a relay you run. Every line is encrypted end to end. 
## What people use it for
* **Testing your own app** on real phones, including flows that cross into other apps, such as a login with a code from a text message.
* **A shelf of phones** running the same routine every day, each through its own network or proxy.
* **Giving an AI agent hands**: through MCP, Claude, ChatGPT, Cursor and other agents can look at a phone screen and act on it.
* **Small personal automations**, such as turning Wi-Fi off at night or collecting a value from an app every hour.
Droidline uses only permissions an ordinary app can get, so a few things are out of reach: see What it cannot do.
## See it in action
 Try the same demo in your browser, and pick elements on a simulated screen, on droidline.dev 
## Quick start
You need a PC (Windows, macOS or Linux) and an Android phone with Android 9 or later, on the same Wi-Fi for a first try. The installation guide walks through each step with screenshots.
1. **Run the server on your PC.** Download the `droidline` archive for your system from Releases, put `droidline` on your `PATH`, and start it. Leave it running.
 [code] 
2. **Install the app on the phone.** Download `droidline-agent.apk` from the same release page and open it. On the app's **Setup** tab, turn on the accessibility service, the Droidline keyboard, notifications and unrestricted battery use. On Android 13 and later, allow **restricted settings** for the app first; the app shows where.
3. **Pair them.** Run this on the PC and scan the QR code with the app's **Pair** tab:
 [code] 
 No camera? Tap **Pair on this Wi-Fi** in the app and type the 6-digit code it shows: `droidline pair 482913`.
4. **Send a command.**
 [code] 
No phone at hand? `droidline-fakephone`, included in every release, simulates one with a small demo app. The first-script tutorial builds a complete login script against it.
## Use it from your language
Every interface talks to `droidline serve` on `localhost:8780` and uses the same command names.
**Python** (`pip install droidline`, Python 3.9+)
 [code] 
**Node.js and TypeScript** (`npm install droidline`, Node.js 18+)
 [code] 
**C# and .NET** (`dotnet add package Droidline`, .NET 8+ or .NET Framework 4.6.2+)
 [code] 
**Command line** (comes with th