Device Detection

Automatic USB and WiFi device detection with real-time monitoring and mDNS support

Overview

APK Extractor automatically detects Android devices connected via USB or WiFi, extracting detailed device information including brand, model, and Android version. The system monitors devices in real-time and supports mDNS auto-connection for wireless debugging.

Detection Methods

USB Device Detection

When you connect an Android device via USB with debugging enabled, APK Extractor instantly detects it using ADB’s device listing:

const out = await runAdb('devices');
const lines = out.split('\n').slice(1);
for (const line of lines) {
  const tabIdx = line.indexOf('\t');
  if (tabIdx === -1) continue;
  const serial = line.substring(0, tabIdx).trim();
  const status = line.substring(tabIdx).trim();
  if (status === 'device' && serial) {
    // Device detected
  }
}

USB devices appear with a serial number identifier (e.g., R58N123456A).

WiFi Device Detection

Devices connected wirelessly appear with their IP address and port:

const isWireless = serial.includes(':') || serial.includes('._adb');

Wireless devices have two formats:

• Manual connection: 192.168.1.100:5555
• mDNS auto-connection: adb-R58N123456A._adb-tls-connect._tcp

Android 11+ supports wireless debugging with automatic mDNS broadcasting. APK Extractor detects these devices automatically without manual pairing.

mDNS Support

For devices using wireless debugging with mDNS (Android 11+), APK Extractor:

1. Detects the mDNS service name format: adb-*._adb-tls-connect._tcp
2. Resolves the device’s IP address using ADB shell commands
3. Extracts device information (brand/model)
4. Auto-saves the device for quick reconnection

if (serial.includes('._adb')) {
  try {
    const ipOut = await runAdb('shell ip route', serial, 5000);
    const srcMatch = ipOut.match(/src\s+([\d.]+)/);
    if (srcMatch) ip = srcMatch[1];
  } catch { }
}

Real-Time Monitoring

The web interface polls for device changes every 4 seconds using an optimized lightweight endpoint:

app.get('/api/devices/poll', async (req, res) => {
  const out = await runAdb('devices', null, 5000);
  const lines = out.split('\n').slice(1);
  const serials = [];
  for (const line of lines) {
    const tabIdx = line.indexOf('\t');
    if (tabIdx === -1) continue;
    const serial = line.substring(0, tabIdx).trim();
    const status = line.substring(tabIdx).trim();
    if (status === 'device' && serial) serials.push(serial);
  }
  res.json({ serials });
});

The polling endpoint only returns serial numbers for performance. Full device info loads when you select a device.

Device Information Extraction

APK Extractor extracts comprehensive device details using ADB’s getprop command:

const props = await runAdb(
  `shell "getprop ro.product.manufacturer && getprop ro.product.model"`,
  serial, 5000
);
const lines = props.trim().split('\n').map(l => l.trim());
const brand = lines[0] || '';
const model = lines[1] || '';
if (brand && model && brand !== 'N/A') label = `${brand} ${model}`;

Properties Collected

Property	ADB Command	Example Value
Brand	getprop ro.product.manufacturer	Samsung
Model	getprop ro.product.model	Galaxy S21
Android Version	getprop ro.build.version.release	13
SDK Level	getprop ro.build.version.sdk	33
Device Codename	getprop ro.product.device	SM-G991B

Parallel Processing

All connected devices are processed in parallel for maximum performance:

const devices = await Promise.all(pending.map(async (serial) => {
  const isWireless = serial.includes(':') || serial.includes('._adb');
  let label = serial;
  let ip = null;

  try {
    const props = await runAdb(
      `shell "getprop ro.product.manufacturer && getprop ro.product.model"`,
      serial, 5000
    );
    const lines = props.trim().split('\n').map(l => l.trim());
    const brand = lines[0] || '';
    const model = lines[1] || '';
    if (brand && model && brand !== 'N/A') label = `${brand} ${model}`;
  } catch { }

  return { serial, status: 'device', label, ip, wireless: isWireless };
}));

Detecting 10 devices takes the same time as detecting 1 device thanks to parallel ADB calls.

How It Works

Technical Flow

1. Poll Detection (every 4s)

   • Execute adb devices command
   • Parse output for device serials
   • Compare with previous state
   • Notify UI of changes

2. Device Selection

   • User clicks on a device
   • Fetch detailed info using getprop commands
   • Extract brand, model, Android version
   • Display in device panel

3. Wireless IP Resolution

   • For WiFi devices, parse serial for IP
   • For mDNS devices, run shell ip route
   • Extract source IP from route table
   • Auto-update saved devices database

4. Auto-Save WiFi Devices

   • Detect wireless connection
   • Extract device label
   • Save to devices.json
   • Enable one-click reconnection

Device Display

Devices appear in the interface with:

• Brand and Model (e.g., “Samsung Galaxy S21”)
• Serial Number (for USB) or IP Address (for WiFi)
• Connection Type indicator (USB/WiFi icon)
• Custom Name (if assigned)

The detection system automatically prioritizes custom names over auto-detected labels, ensuring your personalized device names always appear first.

Performance Optimization

Caching Strategy

• Device list cached in memory
• Polling only fetches serial numbers
• Full device info loaded on demand
• 5-second timeout for responsiveness

Error Handling

try {
  const props = await runAdb(
    `shell "getprop ro.product.manufacturer && getprop ro.product.model"`,
    serial, 5000
  );
  // Process properties
} catch {
  // Fallback to serial number
  label = serial;
}

If device info extraction fails, APK Extractor gracefully falls back to displaying the serial number.