android-notes/shadowauto — explained in plain English
Analysis updated 2026-05-18
Automate a repetitive task inside a mobile app without touching the phone yourself
Let an AI agent operate an Android app on a hidden virtual screen while you keep using the phone normally
Prototype an AI phone assistant that reads the screen and taps through real apps
| android-notes/shadowauto | datafusion-contrib/streamfusion | jdubois/boot-ui | |
|---|---|---|---|
| Stars | 51 | 49 | 49 |
| Language | Java | Java | Java |
| Setup difficulty | hard | hard | easy |
| Complexity | 4/5 | 5/5 | 2/5 |
| Audience | developer | ops devops | developer |
Figures from each repo's GitHub metadata at analysis time.
Needs ADB debugging, a shell-level Android setup, and your own AI API key that supports tool calls.
ShadowAuto is an open source prototype for Android phones that runs apps quietly in the background while you keep using your screen normally. It works by starting a special process through Android's developer tools known as adb, then launching a real Android app inside a hidden virtual display that the phone owner cannot see on the normal screen. An AI model then controls that hidden app the same way a person would: tapping buttons, typing text, scrolling, and reading what is on the virtual screen, while your actual screen stays free for you to use the phone as normal. To understand what is happening on the hidden screen, ShadowAuto reads the same information Android's accessibility tools use, listing windows, buttons, and text fields. When that information is missing or incomplete, it falls back to optical character recognition to read text directly from the screen image. The AI repeats a loop of choosing an action such as tap, type, scroll, go back, search, or wait, until the task is finished. The project has three main pieces: a shell process that lives on the phone and does the actual automation, a controller app used to type in a goal and watch progress, and a browser based launcher that lets you connect a phone over USB and start everything without touching a terminal. It works on any Android 10 or newer device, needs USB debugging turned on, and does not require the phone to be rooted. You also need your own key for an AI service that supports tool calls, since ShadowAuto sends the model instructions and receives back the actions to take. An example task shown in the project is asking the app to order food through a delivery app on your behalf. Multiple tasks can run at once, though the project notes that running too many at the same time can slow the phone down or make it warm. The interface and much of the documentation are available in both English and Chinese.
An Android prototype that lets an AI silently control real apps on a hidden virtual screen while you keep using your phone.
Mainly Java. The stack also includes Java, Android, Svelte.
Setup difficulty is rated hard, with roughly 1h+ to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.