Phones: control a whole rack of Android phones from your PC
Turn on USB debugging, connect ADB, the connection assistant that finds problems, shared commands for the whole rack, the full Box Phone inside the tool, proxies for phones and the phone command reference.
The phone features run scripts on real Android phones plugged into the PC by USB: 15 phones at once, and one phone failing does not affect the others.
How it works
| Part | What it is | Think of it as |
|---|---|---|
| ADB | The "talk line" between the PC and the phone over USB | A phone line |
| uiautomator2 | A small app installed on the phone that lets the tool read the screen as text and tap / type / swipe like a finger | Someone who reads the screen and taps for you |
| Thread | Each phone runs its own thread | One worker per phone |
| Script | A list of steps, like a browser script | A work instruction sheet |
Strong point: the tool finds buttons by text (e.g. Log In|Đăng nhập), so it taps correctly on phones with different resolutions.
Preparation (once)
- On every phone: Settings → About phone → tap Build number 7 times to unlock Developer options → turn on USB debugging. If there is USB debugging (Security settings), turn it on too.
- Better turn off the PIN / screen lock so the tool can unlock the phone.
- Plug in the cable. The phone asks "Allow USB debugging?" → tick Always allow → OK.
The Phones page in the tool
Connection & shared commands tab
- The connection assistant checks each step and writes the fix right below any failing one: is there a box_phone folder, are the libraries installed, is ADB running, are phones visible.
- Phone "not allowed": unlock the screen → tick Always allow. Phone "disconnected": replug, change the port, or Restart ADB.
- Phone table: phone name, serial, status, battery.
- Shared commands for all or one phone: 💡 Wake, 🌙 Screen off, 🏠 Home, ◁ Back, 🔋 Battery, Open link.
Box Phone (full) tab: click it and the tool starts Box Phone in the background and shows its whole interface inside the page (5–15 seconds the first time). Here you write phone scripts, Scan screen (lists every button / text / input visible), run and read reports.
Proxies for phones
Phones cannot fill in proxy user/password themselves, so the PC sits in between and does it:
- Paste proxies, one per line: line 1 for phone 01, line 2 for phone 02… Or add a
PROXYcolumn to the account file. - Pick how to connect: Over USB (recommended, no shared wifi needed) or Over wifi (the phone uses
PC IP:port). - Test proxy → Assign proxy to selected phones. The tool sets the proxy on the phone and prints the IP the phone will use.
- Closing the tool removes the proxies. If the PC shuts down suddenly the phones lose internet: reopen the tool and press Remove proxy or Assign again.
Scripts have commands to assign a proxy, remove it and check the IP, so you can be sure each phone uses the right proxy.
Account data for phones
Excel / CSV file: column MAY = phone number (01, 02…), other columns depend on the job (EMAIL, PASS, LINK…). Leave MAY empty and accounts are shared out in phone order. In scripts use {@EMAIL}, {$variable}, {may}.
Phone command reference
Read from the installed Box Phone (51 commands):
📱 Apps · 7 commands
open_appNEWOpen an installed app. Don't know the package name? Press « 📱 Pick app on test phone » to search a list, or open the app by hand on the test phone and press « Get RUNNING app ».
close_appNEWForce-close the app (like swiping it away in recents).
clear_appNEWClearing app data = logged out, like a fresh install.
uninstall_appNEWUninstall the app from the phone.
install_apkNEWInstall an .apk from the PC onto the phone. Skipped if already installed.
install_storeNEWOpens the Play Store, taps Install, waits for it to finish.
open_linkNEWOpen a link. Choose an app to open it there directly (e.g. discord.gg links in Discord).
👆 Tap & type · 12 commands
tapNEWTap a button / text / field. Press 🎯 to pick it on the test phone's screen, or 📷 to click on a screenshot.
long_tapNEWLong-press a button (opens menus…).
typeNEWTap a field then type. From the account file: {@EMAIL}, {@PASS}…; from a variable: {$name}. No field chosen = type into the focused field.
type_excelNEWEach phone types one line of one COLUMN of the Excel/CSV: phone 01 → 'From line', phone 02 → next line… E.g. 15 phones, From line 1 → lines 1-15; From line 16 → lines 16-30. Line 1 = right below the header row.
tap_imageNEWFor apps whose buttons can't be read (games, drawn UIs…): the tool keeps taking screenshots and taps the centre of the template when found. Press ✂ to crop a template from the test phone's screen.
swipeNEWSwipe to scroll / switch tabs.
scroll_findNEWKeep swiping until the text / button appears (long lists).
pressNEWPress one key (all PC keyboard keys + phone keys + Ctrl/Shift/Alt combos). Type a few letters in the Key box to filter (e.g. 'ctrl', 'arrow', 'f5'). Other combos can be typed by hand, e.g. ctrl+shift+t.
backNEWPress the Back button (◁).
homeNEWGo to the home screen.
rotateNEWLock the screen to PORTRAIT (or landscape); apps can't rotate it. Pick 'Auto rotate' to restore. Best placed at the start of the script.
wakeNEWTurn the screen on and swipe up to unlock (phone without a passcode).
⏳ Wait · 4 commands
wait_imageNEWWait until the template image appears (no tap). Reports an error on timeout.
waitNEWPause a few seconds. '2-4' = random 2 to 4 seconds to look human.
wait_forNEWWait until the screen shows this text / button (e.g. wait for a page to load).
wait_goneNEWWait until this text / button disappears (e.g. 'Loading').
🔀 Conditions & loops · 13 commands
if_existsNEWRun the steps below only IF the screen shows this text / button. The tool adds END IF after it.
if_imageNEWRun the steps below IF the screen shows this template image. The tool adds END IF after it.
if_no_imageNEWRun the steps below IF the screen does NOT show this template image.
if_missingNEWRun the steps below only IF this text / button is NOT seen.
if_appNEWRun the steps below if this app is installed.
if_no_appNEWRun the steps below if the app is NOT installed (e.g. to install it).
if_varNEWCompare a variable (from a 'Read text into variable' step).
elseNEWPlace between IF … and END IF: the steps after it run when the condition is FALSE.
end_ifNEWCloses the IF block.
repeatNEWRepeat the steps below N times. The tool adds END LOOP after it. Inside the loop: {$lap} = pass 1, 2, 3…; {$lap0} = 0, 1, 2… (put it in 'Index' so pass 1 taps the first, pass 2 the second…); {$lap_ten} = blank, 1, 2… (e.g. Discord{$lap_ten} → Discord, Discord1, Discord2).
end_repeatNEWCloses the loop.
breakNEWLeave the LOOP immediately.
auto_closeNEWPlace once at the START of the script. From then on, whenever the tool is looking for a button and sees a popup with this text (e.g. Protections for Teens), it taps the dismiss button (e.g. Got It) and carries on.
📦 Data & variables · 9 commands
get_textNEWRead the text of an on-screen element into a variable, reuse it with {$name}.
set_varNEWAssign a value to a variable, reuse it with {$name}.
totpNEWGenerate the 6-digit code from the 2FA secret (SECRET column of the account file), save it to {$otp}.
totp_excelNEWTake the 2FA SECRET from an Excel column (phone 01 → 'From line', phone 02 → next line…), compute the 6-digit code, save it to a variable (default {$otp}). Tick 'Type right away' to type it into a field now, or use 'Type into field' with {$otp} in a later step.
screenshotNEWTake a screenshot into the anh_chup/ folder.
logNEWWrite one line to the log (for tracking).
reportNEWAppend one line to bao_cao/<file>.csv (time, phone name, serial added automatically). Separate columns with | ; variables allowed, e.g. {$clone}|{$link}|OK.
notifyNEWShow a toast on the phone (e.g. a reminder to do something by hand).
shellNEWRun any adb shell command (for advanced users).
🌐 Network & proxy · 4 commands
set_proxyNEWAttach a proxy to the phone (by phone number in the Proxy tab, or the PROXY column of the account file).
rotate_proxyNEWPlace at the START of each account: once an IP served N accounts, call the provider API to change IP, wait for the new one, check for duplicates with other phones. Set token / N on Proxy page → Rotate proxy. IP saved to {$ip}.
clear_proxyNEWRemove the proxy, the phone uses its real network.
check_ipNEWOpen an IP-check page in Chrome on the phone, save it to {$ip_may}.
🏁 End · 2 commands
doneNEWStop this phone and report SUCCESS.
failNEWStop this phone and report ERROR with a reason.
No matching commands.
Honest limits
- Captchas inside apps (hCaptcha…) are not solved automatically yet; a script can wait for you to solve it by hand and then continue.
- Many accounts on the same wifi / IP get flagged easily. Use a separate 4G SIM or a proxy per phone.