What is this?
A web port of the 'Jam Android Toolbox' (搞机工具箱), a graphical ADB tool for managing Android phones. It runs in Chrome or Edge over WebUSB with nothing to install.
A web port of the 'Jam Android Toolbox' (搞机工具箱), a graphical ADB tool for managing Android phones. It runs in Chrome or Edge over WebUSB with nothing to install.Is it a website or a program I install?It's a web app: a static page opened in a Chromium browser that talks to the phone over USB through WebUSB, so there is nothing to install.
It's a web app: a static page opened in a Chromium browser that talks to the phone over USB through WebUSB, so there is nothing to install.How do I get it running?Simplest: download docs/index.html (the all-in-one version with dependencies embedded) and open it in Chrome or Edge. For the split version, keep the folder structure and serve it from localhost or HTTPS. server.cjs is an optional Node.js helper, and no npm install or build is needed.
Simplest: download docs/index.html (the all-in-one version with dependencies embedded) and open it in Chrome or Edge. For the split version, keep the folder structure and serve it from localhost or HTTPS. server.cjs is an optional Node.js helper, and no npm install or build is needed.What do I need before connecting?A Chromium browser (Chrome or Edge), an Android phone with developer options and USB debugging on, a data-capable USB cable, and approval of the USB debugging prompt on the phone the first time. On Windows the ADB USB interface must also be recognised.
A Chromium browser (Chrome or Edge), an Android phone with developer options and USB debugging on, a data-capable USB cable, and approval of the USB debugging prompt on the phone the first time. On Windows the ADB USB interface must also be recognised.What's the catch?Only wired USB for now. Results depend on the Android version, ROM and ADB shell permissions, and some devices don't expose CPU or board ID data. The Fastboot button only sends a reboot, with no flashing. Refreshing the page drops the USB session.
Only wired USB for now. Results depend on the Android version, ROM and ADB shell permissions, and some devices don't expose CPU or board ID data. The Fastboot button only sends a reboot, with no flashing. Refreshing the page drops the USB session.How is the web version built?It uses Tango / ya-webadb for the WebUSB ADB connection and xterm.js for the terminal, with the BAT script runner written in JavaScript. It is a port of the author's PC toolbox and is open source under GPL-3.0.
It uses Tango / ya-webadb for the WebUSB ADB connection and xterm.js for the terminal, with the BAT script runner written in JavaScript. It is a port of the author's PC toolbox and is open source under GPL-3.0.Can I use the ADB terminal like a normal Android shell?Yes. It opens an interactive Android Shell with ANSI output, command history, completion, copy, clear, and Ctrl+C to interrupt. The session keeps its directory and variables across page switches but ends when the device disconnects.
Yes. It opens an interactive Android Shell with ANSI output, command history, completion, copy, clear, and Ctrl+C to interrupt. The session keeps its directory and variables across page switches but ends when the device disconnects.How do the BAT scripts work on the web?A JavaScript interpreter runs a subset of BAT syntax (echo, set, goto, if, for /l, timeout, choice, pause) and turns ADB commands into browser calls. It does not run cmd.exe or PC EXEs. Scripts that push or install local files need those files linked in the page first, and external programs or PowerShell are not supported.
A JavaScript interpreter runs a subset of BAT syntax (echo, set, goto, if, for /l, timeout, choice, pause) and turns ADB commands into browser calls. It does not run cmd.exe or PC EXEs. Scripts that push or install local files need those files linked in the page first, and external programs or PowerShell are not supported.