adb-qr
v1.0.0
Published
ADB with frictionless QR Code pairing. (Wireless Android Debug Bridge pairing via QR Code, auto-discovers mDNS, downloads platform-tools automatically).
Maintainers
Readme
adb-qr
A zero-configuration, frictionless Wireless Android Debug Bridge (ADB) connector directly in your terminal.
adb-qr serves two primary purposes:
- Frictionless QR Code Connection: Dramatically simplify connecting to Android 11+ devices wirelessly. Run the command, scan the QR code generated in your terminal from your phone's Developer Options, and
adb-qrhandles the rest (mDNS discovery, pairing, connecting, and duplicate device cleanup automatically). - Universal ADB Proxy: Never worry about installing the Android SDK or
platform-toolsmanually again.adb-qracts as a direct proxy for all standardadbcommands. Ifadbisn't installed locally or in your PATH, it will intelligently download the correct binaries for Windows, macOS, or Linux automatically.
Quick Start (Zero Install)
Just run adb-qr via npx anywhere on your machine—no global setup required!
npx adb-qr📱 1. Frictionless Wireless Pairing (QR Code)
Run the script without arguments (or with the qr keyword) to enter frictionless pairing mode:
npx adb-qr qrHow to pair:
- Open your Android Settings > Developer Options.
- Scroll to and tap Wireless Debugging to enable it.
- Tap Pair device with QR code.
- Scan the QR code rendered directly inside your terminal window!
The bridging happens entirely in the background. The script auto-discovers your phone via mDNS, manages the pairing credentials securely, connects your device, and isolates the active IP connection automatically.
🚀 2. Drop-in ADB Proxy
adb-qr completely wraps the standard ADB binary. You can append any standard ADB command directly to adb-qr, and it will pass it through elegantly!
# Examples:
npx adb-qr devices
npx adb-qr logcat
npx adb-qr shell
npx adb-qr install ./my-app.apk
npx adb-qr tcpip 5555✨ Automated Download: If you run a proxy command and ADB isn't on your machine, adb-qr will prompt you to safely and quickly download the latest official platform-tools release from Google for your operating system automatically before running the command.
🔄 3. Force Update / Install ADB
You can instruct adb-qr to forcefully download or update the underlying platform-tools binaries. It will compare versions and report the upgrade!
npx adb-qr update(Aliases: download, upgrade, install)
Help Menu
Display the help menu:
npx adb-qr help