Metadata-Version: 2.4
Name: adb-connect-qr
Version: 0.1.3
Summary: A Python CLI tool for pairing Android 11+ wireless debugging using QR codes
Author-email: Adam Outler <adamoutler@gmail.com>
Project-URL: Homepage, https://github.com/adamoutler/adb-connect-qr
Project-URL: Repository, https://github.com/adamoutler/adb-connect-qr
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: zeroconf>=0.131.0
Requires-Dist: qrcode>=7.4.2

# adb-connect-qr

Easy connection for wireless adb.

**Watch the demo:** [YouTube Video](https://www.youtube.com/watch?v=SXBMxuTbqqg)

## Example Session

```
$ adb-connect-qr
Starting ADB QR Code Pairing...

Scan this QR code in Android > Developer Options > Wireless Debugging > Pair device with QR code

Service Name: adb-cli-faXn2w
Password: Qp3hUJ

```

![QR Code](images/qr-code.png)

```
Waiting for device to scan QR code (timeout 60s)...
Device found at 192.168.1.39:37479. Initiating pairing...
Running: adb pair 192.168.1.39:37479 Qp3hUJ
Successfully paired to 192.168.1.39:37479 [guid=adb-57161FDCG001PE-HgzRvA]

Pairing successful! Waiting for connection service...
Running: adb connect 192.168.1.39:42865
connected to 192.168.1.39:42865

Successfully paired and connected!
```

## Setup Instructions

### Prerequisites
* Python 3.8+
* `adb` installed and available on your system PATH.

### Installation
You can install this tool directly from PyPI:

```bash
pip install adb-connect-qr
```

### Usage
Simply run the command in your terminal:
```bash
adb-connect-qr
```
Then go to your Android device:
1. Open **Settings** > **Developer Options** > **Wireless Debugging**.
2. Tap **Pair device with QR code**.
3. Scan the QR code displayed in your terminal.
