Quickstart

This walkthrough covers launching the app, connecting a device, and seeing your first mirror.

1. Launch

   macOS

   Open Emu from your Applications folder, Spotlight, or run emu from a terminal.

   Linux

   Run emu from your terminal.

   Windows

   Double-click emu.exe, or run emu from a terminal.

   You will see the device list showing all connected physical devices and available Android Virtual Devices (AVDs).

   Tip

   If you don’t have the Android SDK installed, Emu will walk you through a setup wizard on first launch to install the SDK, accept licenses, and download a system image.

2. Connect a device

   Connect a physical device via USB or start an emulator.

   • Physical device: Plug in via USB or pair wirelessly — open Wireless pairing from the toolbar and scan the QR code shown in your device’s Developer Options.
   • Emulator: Click the play icon next to an AVD in the device list to start it. If you don’t have any AVDs yet, click Create AVD to set one up — pick a device profile, system image, and Emu handles the rest.

3. Mirror

   Click on your device in the list to open the live mirror. Emu establishes a high-performance connection to show a GPU-accelerated view of the device screen at native resolution.

4. Interact

   Use your mouse and keyboard to control the device.

   • Touch: Click and drag to simulate taps and swipes.
   • Keyboard: Type directly into focused text fields.
   • Command palette: Press Ctrl+K (or Cmd+K on macOS) to search for apps and actions.

What’s next

• Live mirror — Learn about multi-touch and recording.
• Network inspector — Inspect HTTP/HTTPS traffic.
• MCP setup — Connect AI agents to your device.