connecting-over-wifi

Pairs Android 11+ devices over Wi-Fi and connects to the post-pairing debug port via mDNS.

303|10|Updated May 15, 2026
One-click install
npx skills add https://github.com/skydoves/android-testing-skills --skill connecting-over-wifi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: connecting-over-wifi
Source: https://github.com/skydoves/android-testing-skills/tree/main/adb/devices/connecting-over-wifi
Command: npx skills add https://github.com/skydoves/android-testing-skills --skill connecting-over-wifi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the frustration of getting wireless debugging working when modern devices need pairing and the host must connect to the correct (post-pairing) port.

Core Features & Use Cases

  • Pair + connect over Wi-Fi (modern and legacy): Supports adb pair for Android 11+ (TLS-based pairing) and the legacy adb tcpip + adb connect fallback.
  • mDNS discovery for hands-off connections: Uses adb mdns check and adb mdns services with _adb-tls-pairing._tcp and _adb-tls-connect._tcp.
  • Avoid common security and connectivity pitfalls: Prevents using the pairing port for debugging, flags Openscreen vs Bonjour mismatches on ADB v34+ defaults, and highlights corporate Wi‑Fi restrictions that can block mDNS/p2p.

Quick Start

Tell your AI agent to connect to your paired Android device by running adb pair for the device’s pairing IP:port, then connect to the separate connect IP:port shown in the Wireless debugging screen or _adb-tls-connect._tcp from adb mdns services.

Frequently Asked Questions about connecting-over-wifi

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix wireless ADB connection refused errors on Android 11+?

Wireless ADB connection refused errors on Android 11+ usually happen when trying to connect to the pairing port instead of the separate post-pairing debug port. You must first run adb pair on the pairing IP:port, then connect to the debug port discovered via _adb-tls-connect._tcp mDNS services.

Why does adb mdns check show Openscreen vs Bonjour mismatches on ADB v34+?

ADB v34+ defaults to Openscreen, causing mDNS backend mismatches if Bonjour is expected. Setting ADB_MDNS_OPENSCREEN resolves these wireless debugging discovery conflicts by enforcing the correct backend for adb mdns services to find _adb-tls-pairing._tcp entries.

How do I use adb pair and adb connect for wireless debugging over Wi-Fi?

To use wireless debugging, run adb pair with the IP and port shown on your device's Wireless debugging screen. Once paired, run adb connect using the separate connect IP:port listed under _adb-tls-connect._tcp from adb mdns services, not the pairing port.

Does wireless ADB work with legacy tcpip mode for older Android devices?

Yes, wireless ADB supports legacy devices using the adb tcpip 5555 fallback followed by adb connect to the device IP. This bypasses the TLS-based pairing required for Android 11+ devices and does not rely on mDNS discovery.

Why is mDNS discovery not finding my Android TV or Wear OS device for wireless debugging?

mDNS discovery fails for Android TV or Wear OS if the platform requirements like API 33+ are unmet or corporate Wi-Fi restricts peer-to-peer traffic. Ensure ADB_MDNS_AUTO_CONNECT is configured and your network permits _adb-tls-connect._tcp traffic.

When should I use adb disconnect instead of closing the terminal during wireless debugging?

You should use adb disconnect to cleanly tear down the TLS connection and release the post-pairing debug port. Simply closing the terminal leaves the mDNS service hanging, which can cause port conflicts or connection refused errors on your next adb connect attempt.