ckandroidproject / ya-webadb

ADB in your browser

Tango

A library and a Web app that allow browsers to interact with Android devices via ADB (Android Debugging Protocol).

All features work on Chrome for Android, use a C-to-C (or OTG) cable.

🚀 Web App | Old Demo

Working Modes

Direct Connection Mode

In this mode, Google ADB is not required for this library to communicate with Android devices (in fact, Google ADB must not be running in order to use this mode).

This mode is suitable for running on end-users' devices where Google ADB is not installed, or on mobile devices where Google ADB is not available.

Before connecting, make sure to close Google ADB (Run adb kill-server in a terminal or close adb.exe from Task Manager) and all programs that may use ADB (e.g. Android Studio, Visual Studio, Godot Editor, etc.).

Google ADB Client Mode

In this mode, this library talks to a Google ADB server, which is either running on the same machine or on a remote machine. This allows other ADB-based tools to work alongside this library.

Compatibility

Connection	Chromium-based Browsers	Node.js
Direct Connection over USB cable	Supported using WebUSB API	Supported using usb package
Direct Connection over TCP	Waiting for Direct Sockets API	Possible using net module
Google ADB client over TCP	Waiting for Direct Sockets API	Supported using net module

API documentation

Currently the API is unstable and the documentation is lacking, but there are three sources you can refer to:

• Each package's README.md file
• The source code of old demo at https://github.com/tango-adb/old-demo (it's a React app)
• The work-in-progress documentation site at https://tango-adb.github.io/docs/adb/installation

Contribute

See CONTRIBUTING.md

Sponsors

Become a backer and get your image on our README on Github with a link to your site.

Used open-source projects

• ADB from Google (Apache License 2.0)
• Scrcpy from Romain Vimont (Apache License 2.0)
• web-streams-polyfill from Mattias Buelens (MIT License)