Skip to content

nwtgck/piping-adb-web

Repository files navigation

Piping ADB

Android Debug Bridge (ADB) over Piping Server on Web browser

Piping ADB scrcpy Piping ADB file manager

Usage

First, open adbd 5555 port on an Android device using adb tcpip 5555 or su 0 setprop service.adb.tcp.port 5555; su 0 stop adbd; su 0 start adbd

Second, the device starts a tunneling over Piping Server in some way, equivalent to the following command:

curl -sSN https://ppng.io/aaa | nc localhost 5555 | curl -sSNT - https://ppng.io/bbb

Finally, open the following URL on a Chromium-based browser.
https://piping-adb.nwtgck.org/#?auto_connect&server=https://ppng.io&cs_path=aaa&sc_path=bbb

Acknowledgements

This project is highly based on ya-webadb. Thanks to the original author!

The following document is from the original README.

MIT license

A library and application for browsers to interact with Android devices via ADB.

All features are working on Chrome for Android, use a C-to-C cable or run WebSockify in Termux to connect.

🚀 Online 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.

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 WIP using 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