Remote Android emulator and device utilities for the Arc CLI ecosystem.

arc-emulator provides tools to discover, connect, and diagnose Android emulators and devices on remote machines via SSH.

go install github.com/yourorg/arc-emulator@latest

1. Add your machine to ~/.config/arc/emulator.yaml:

machines:
  homelab:
    ssh_host: homelab

2. List available AVDs:

arc-emulator avd list homelab

3. Launch with --smart (handles keys, cleanup, auth automatically):

arc-emulator launch homelab Pixel_5_API_35 --headless --smart

4. Connect and mirror the screen:

arc-emulator connect homelab emulator-5554

• machine - Manage configured machines
• device - List and manage connected devices
• avd - List and manage Android Virtual Devices
• launch - Launch emulators on remote machines
• stop - Stop running emulators
• connect - Connect to emulators via ADB
• disconnect - Disconnect from emulators
• status - Show emulator connection status
• doctor - Diagnose and fix connection issues
• keys - Manage ADB keys
• record - Record emulator screen
• screenshot - Take emulator screenshots
• install - Install APKs on emulators
• shell - Open ADB shell on emulator
• logcat - Stream emulator logs
• pair - Pair with wireless devices
• wireless - Connect to wireless devices

Configuration is stored in ~/.config/arc/emulator.yaml. You can specify an alternate path with the ARC_EMULATOR_CONFIG environment variable.

MIT License - See LICENSE file for details.