Overview
Pilot Control provides:- Device listing and status monitoring
- Qaptly Mac Command service control
- Android Qaptly Auto Service management
- iOS WebDriverAgent setup
- Connected client tracking
Interface Layout
Qaptly Mac Command Service
The Qaptly Mac Command service is the backend service that communicates with devices.Service Status
- ● Running (Green): Service is active
- ● Stopped (Red): Service is not running
Toggle Service
Click the Toggle Service button to start or stop the service.Note: The service must be running for device detection and streaming.
Device Tabs
Devices Tab
Lists all connected devices:- Android devices with resolution
- iOS devices with WDA status
- Device status indicators
Services Tab
Service configuration and status:- Backend service connections
- API endpoints
- Connection health
Clients Tab
Lists connected test execution clients:- Client identifiers
- Connection status
- Active sessions
Android Devices
Device List
Android devices show:- Device name/model
- Screen resolution
- Connection status
- Available actions
Qaptly Auto Service
For Android automation, you need the Qaptly Auto Service installed on the device.Check Status
- Select an Android device
- View the service status indicator:
- Installed: Service is ready
- Not Installed: Needs installation
- Update Available: New version available
Install/Update Service
- Select the device
- Click Install or Update
- Wait for APK installation
- Grant required permissions on device
Required Permissions
The Qaptly Auto Service needs:- Accessibility service access
- Display over other apps
- Storage access (for screenshots)
iOS Devices
Device List
iOS devices show:- Device name/model
- WebDriverAgent status
- Connection status
- Available actions
WebDriverAgent (WDA) Status
- WDA Ready: WebDriverAgent is running
- WDA Setup Required: Needs configuration
- WDA Not Running: Need to start WDA
Setup WDA
- Click Setup WDA on an iOS device
- Follow the iOS Device Setup wizard
Device Actions
For All Devices
- Refresh: Update device status
- View Details: See device information
For Android
- Install Service: Install Qaptly Auto
- Update Service: Update to latest version
- Start Stream: Begin screen mirroring
For iOS
- Setup WDA: Configure WebDriverAgent
- Start WDA: Launch WDA server
- Start Stream: Begin screen mirroring
Refreshing Device List
Manual Refresh
Click the 🔄 Refresh button to:- Scan for new devices
- Update device statuses
- Check service states
Automatic Detection
Qaptly automatically detects:- USB device connections
- Device disconnections
- Status changes
Troubleshooting
Android Device Not Showing
- Check USB connection
- Enable USB debugging on device
- Accept USB debugging prompt on device
- Refresh device list
iOS Device Not Showing
- Check USB connection
- Trust this computer on device
- Ensure Xcode recognizes device
- Refresh device list
Service Not Starting
- Check Qaptly Mac Command installation
- Review system permissions
- Check console for errors
- Restart Qaptly application
Related: