Support

⚡ Quick Setup Guide

  1. On your Android TV, go to Settings → About and tap "Build Number" 7 times to enable Developer Options
  2. Go to Settings → Developer Options and enable USB Debugging
  3. In the same menu, enable ADB over network
  4. Note the IP address shown (or find it in Settings → Network)
  5. Open AirHQ on your iPhone, enter the IP address, and tap the WiFi icon to connect
  6. A dialog will appear on your TV — select "Always allow" and confirm

🔍 Troubleshooting

Cannot connect / Connection timeout
  • Ensure both devices are on the same WiFi network
  • Verify ADB over network is enabled
  • Check that the IP address is correct
  • Try toggling USB Debugging off and on
  • Check "AP Isolation" is disabled on your router
Connection drops when switching apps

iOS suspends background apps. AirHQ auto-reconnects when you return. If it fails, tap the WiFi icon to reconnect.

Commands timeout / "Read timeout"
  • Disconnect and reconnect
  • Device may be under heavy load — wait and retry
  • Add | head -50 to limit large output
Remote buttons not working

Verify the green indicator is shown. Some custom launchers may not respond to all key codes.

Screenshot is slow

Speed depends on your Android TV hardware. Budget boxes may take 5-15 seconds.

"Authorization Required" keeps appearing
  • Check "Always allow from this computer" on TV
  • Try Settings → Regenerate ADB Key, then reconnect

📱 Supported Devices

  • Android TV boxes (Xiaomi Mi Box, Nvidia Shield, generic boxes)
  • Google Chromecast with Google TV
  • Fire TV Stick (with ADB enabled)
  • Android phones and tablets (wireless debugging)
  • Android 5.0 (API 21) or later

📧 Contact Us

Questions, bugs, or feature requests?

✉️
loading...

We typically respond within 24 hours

📋 App Info

Version: 1.0.0   Protocol: ADB v1.0 over TCP/IP   Requires: iOS 16.0+