⚡️ DeskDroid — High-Performance Android Screen Mirroring & Workstation for macOS & Windows

Silky-smooth, low-latency Android screen mirroring, remote control, and developer powerhouse for macOS and Windows over Wi-Fi & USB. Built with Flutter Desktop and scrcpy-server.

   
_{macOS: Universal Binary (30 MB) • Apple Silicon (M1/M2/M3/M4) & Intel Core • macOS 12.0+
Windows (Preview): portable ZIP (13 MB) • Windows 10/11 x64 • what works on each platform}

🚀 Why DeskDroid?

DeskDroid turns your Mac or Windows PC into the ultimate Android command center. Whether you are an Android developer debugging apps, a content creator recording mobile gameplay, or a power user seeking desktop control over your phone, DeskDroid delivers:

• ⚡️ Low-Latency Native Decoding: Hardware H.264 encoding on the phone, decoded natively on the desktop (Apple VideoToolbox on macOS, Media Foundation on Windows) at up to 60 FPS, at the phone's own resolution.
• 📶 Dual Connection (Wi-Fi & USB): Subnet ARP auto-discovery, mDNS wireless debugging, 1-click USB-to-Wi-Fi switch, or instant plug-and-play USB cable mode.
• 🔋 Screen-Off Streaming: Keep the physical phone screen dark while you keep mirroring and controlling it, for privacy and less battery drain from the display.
• 🔒 100% Private & P2P: Zero cloud servers, zero analytics, and zero telemetry. All video, audio, and inputs remain strictly inside your local network.

📸 Visual Showcase

1. Subnet Discovery & Built-in Feature Catalog

Multi-Device Discovery Subnet auto-scan, connection badges & 1-click wireless mirroring.

Interactive Feature Showcase Categorized catalog with performance badges, highlights & pro tips.

2. Developer Inspection: Logcat & Intent Dispatcher

Device Logcat Console (Cmd+Shift+L) Live stream (batched every 100 ms), 5k ring buffer, regex/PID/tag filters, star bookmarks & recording to a file.

Deep Link & Intent Dispatcher (Cmd+Shift+D) Fire custom URI schemes, system actions, targeted packages & typed extras.

3. App Deployment & Two-Way File Management

1-Click APK Manager (Cmd+Shift+I) AAPT2 metadata inspection, permission grant flags, 1-click launch & clean uninstall.

Device File Explorer (Cmd+Shift+F) Two-way file browser with quick folder shortcuts & batch download.

4. Lossless Media Capture & Screen Recording

Hardware Screen Recording (Cmd+Shift+R) H.264 MP4 encoded by the phone's hardware encoder (up to 3 minutes), with a 3 s countdown HUD.

Interactive Area Crop (Cmd+Shift+S) PNG marquee crop with live pixel badge; copy, save, or both.

⚡️ Complete Feature Catalog

DeskDroid includes 14 built-in modules (plus a planned menu bar companion):

Shortcuts are shown with Cmd (macOS); use Ctrl on Windows. Most features are verified on macOS; the Windows preview has verified mirroring, logcat, bitrate presets, and the MCP server. Audio forwarding (Android 11+) is new and not yet verified in the app on either platform. Full matrix: Platform Support.

⌨️ Essential Keyboard Shortcuts

Use Cmd on macOS and Ctrl on Windows (for example Ctrl + Shift + S). Tooltips in the app always show the keys of the running platform.

🏗️ Architecture

flowchart LR
    subgraph AndroidDevice ["📱 Android Device"]
        A1["SurfaceControl / Display Capture"] --> A2["MediaCodec (H.264 hardware)"]
        A2 --> A3["scrcpy-server (Shell-level daemon)"]
        A4["InputManager (Touch / Key Injection)"] <--- A3
    end

    subgraph Transport ["📶 Local Wi-Fi (LAN) / 🔌 USB Cable"]
        V_STREAM["TCP Video Stream (Raw NAL Units)"]
        A_STREAM["TCP Audio Stream (Raw PCM, Android 11+)"]
        C_SOCKET["TCP Control Socket (scrcpy Control Messages)"]
    end

    subgraph DesktopApp ["💻 macOS / Windows (DeskDroid App - Flutter)"]
        M1["Flutter UI"] --> M2["Mouse & Keyboard Event Listener"]
        M3["Native Video Decoder (VideoToolbox / Media Foundation) → Texture"] --> M1
    end

    A3 === V_STREAM ===> M3
    A3 === A_STREAM ===> M4["Native Audio Player (AVAudioEngine / WASAPI)"]
    M2 === C_SOCKET ===> A3

🛠️ Quick Start & Installation

Prerequisites

Install a release

• macOS: unzip DeskDroid-v1.1.0-macOS.zip, move DeskDroid.app to /Applications. Unsigned build: run xattr -cr /Applications/DeskDroid.app once if Gatekeeper blocks it.
• Windows: unzip DeskDroid-v1.0.1-Windows-x64.zip (the latest Windows package; it needs an installed ADB) and run DeskDroid\desk_droid.exe (no installer). Unsigned build: on the SmartScreen prompt choose More info → Run anyway.

Run from source

# 1. Clone repository
git clone https://github.com/az-coder-123/desk-droid.git
cd desk-droid

# 2. Install dependencies & launch
flutter pub get
flutter run -d macos     # macOS
flutter run -d windows   # Windows (needs Visual Studio 2022 with "Desktop development with C++")

Build a release package

./scripts/build_release.sh                                            # macOS → RELEASE/DeskDroid-v<version>-macOS.zip
powershell -ExecutionPolicy Bypass -File scripts\build_release.ps1     # Windows → RELEASE\DeskDroid-v<version>-Windows-x64.zip

Full setup, ADB drivers, and packaging options: Installation & Building. Publishing a release: Release Guide.

📚 Documentation Hub

🏷️ Search Keywords & Tags

android-screen-mirroring · scrcpy-macos-gui · scrcpy-windows-gui · wireless-adb · screen-mirror-mac · screen-mirror-windows · flutter-desktop · apple-silicon · android-logcat-gui · apk-installer-mac · deep-link-tester · android-file-transfer-mac · low-latency-streaming · open-source

🤝 Community, Contributing & License

Developed and maintained by az-coder-123