Wireless Pairing

Wireless Pairing

Connect your Android phone to VS Code over Wi-Fi — no USB cable needed.

QR Code Pairing (Android 11+)

The fastest way to pair a phone wirelessly:

1. Open VS Code Command Palette → Caspian: Connect Device via Wi-Fi
2. Select Pair with QR Code (Android 11+)
3. A panel opens with a QR code and a 6-digit backup code
4. On your phone: Settings → Developer Options → Wireless Debugging → Pair device with QR code
5. Point the phone's camera at the QR code in VS Code
6. The panel shows live progress: waiting → TLS connected → exchanging keys → paired
7. The device appears in the Connected Devices panel

Requirements:

• Android 11 or later
• Phone and computer must be on the same Wi-Fi network
• Wireless Debugging must be enabled in Developer Options

Troubleshooting:

• If the QR code isn't scanned, check that both devices are on the same network
• Corporate networks with client isolation may block mDNS discovery — use the manual pairing code shown below the QR code
• If pairing times out after 120 seconds, click Regenerate to get a fresh QR code

Manual Wireless Debugging (Android 11+)

1. Open VS Code Command Palette → Caspian: Connect Device via Wi-Fi
2. Select Wireless Debugging (Android 11+)
3. Enter the pairing code and IP:port shown on your phone's Wireless Debugging screen

TCP/IP Connection (Any Android)

1. Connect the phone via USB first
2. Open VS Code Command Palette → Caspian: Connect Device via Wi-Fi
3. Select TCP/IP (any Android)
4. The extension switches the phone to TCP/IP mode and connects — you can then unplug the USB cable

Disconnect

Use Caspian: Disconnect Wi-Fi Device from the Command Palette to disconnect a wirelessly connected device.