/ya-webadb

ADB in your browser

Primary LanguageTypeScriptMIT LicenseMIT

Tango

MIT license

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 or via WebSockify running in Termux (see compatibility table below).

🚀 Web App | Old demo

For USB connection, 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.) before connecting.

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.

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 Firefox Node.js
USB cable Supported using WebUSB API No Supported using usb package
Wireless through WebSocket 1 Supported Supported Possible using ws package
Wireless through TCP Waiting for Direct Sockets API No Possible using net module

1 Requires WebSockify softwares, see instruction for detail.

Features

  • 📁 File Management
    • 📋 List
    • ⬆ Upload
    • ⬇ Download
    • 🗑 Delete
  • 📷 Screen Capture
  • 📜 Terminal Emulator powered by Tabby
    • Tabs and split panes
    • Color themes
    • Rich configuration
  • ⚙ Enable ADB over WiFi
  • 📦 Install APK
  • 🎥 Scrcpy compatible client
    • Screen mirroring
    • Audio forwarding (Android >= 11)
    • Recording
    • Control device with mouse, touch and keyboard
  • 🐛 Chrome Remote Debugging that supporting
    • Google Chrome (stable, beta, dev, canary)
    • Microsoft Edge (stable, beta, dev, canary)
    • Opera (stable, beta)
    • Vivaldi
  • 🔌 Power and reboot to different modes

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