ADB Mirror

Embed Android device mirroring directly in VSCode/Cursor using ADB.

Features

• 🖥️ View your Android device/emulator screen directly in VSCode
• 🎮 Control your device from the embedded view (tap, swipe, etc.)
• 🔄 Automatic device detection
• ⚙️ Configurable settings
• 🔄 Automatic orientation detection

Requirements

• ADB installed and in your PATH
• Android device connected via USB or emulator running

Installation

1. Install from the VSCode Marketplace
2. Or install from VSIX: code --install-extension adb-mirror-0.1.0.vsix

Usage

1. Connect your Android device or start an emulator
2. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
3. Run command: ADB Mirror: Start Device Mirror
4. Select your device if multiple are available
5. Your device screen will appear embedded in VSCode!
6. Click on the screen to interact with your device

Configuration

Open Settings (Ctrl+,) and search for "ADB Mirror":

• adbMirror.adbPath: Path to ADB executable (default: "adb")
• adbMirror.serverPort: Port for the web server (default: 8888)

Commands

• ADB Mirror: Start Device Mirror - Start mirroring a device
• ADB Mirror: Stop Device Mirror - Stop the current mirror session
• ADB Mirror: Select Device - List and select available devices

Troubleshooting

No devices found

• Make sure ADB is in your PATH
• Check that your device is connected: adb devices
• Enable USB debugging on your device

ADB not found

• Install ADB: https://developer.android.com/studio/command-line/adb
• Add ADB to your PATH or set the path in settings

How it works

This extension uses ADB (Android Debug Bridge) to:

• Capture screenshots periodically (~10 FPS) using adb exec-out screencap -p
• Send touch commands using adb shell input tap
• Send swipe gestures using adb shell input swipe
• Control your device directly from VSCode

Development

Building

npm install
npm run compile

Testing

1. Open the project in VSCode
2. Press F5 to open a new window with the extension loaded
3. Test the commands from the command palette

Packaging

npm install -g vsce
vsce package

Publishing

vsce publish

License

MIT

Contributing

Contributions are welcome! Please open an issue or submit a pull request.