AndroLaunch

AndroLaunch - Your Android Device Management Hub for macOS, Windows & Linux

AndroLaunch is a professional and powerful cross-platform application (macOS, Windows & Linux) designed to give you effortless control over your Android devices using the power of ADB (Android Debug Bridge) and Scrcpy. Manage quick settings, launch apps, install APKs, and even mirror your device screen—all from one convenient spot.

🚀 Key Features at a Glance

Category	Features	New in Latest Release
Setup & Connectivity	First-launch onboarding wizard, automatic device detection, ADB status monitoring.	Onboarding Wizard, Wireless Pairing via QR Code, dedicated ADB Shell terminal.
Quick Controls	Toggle Wi-Fi, Bluetooth, Mobile Data, Location, DND, Auto-Rotate. Adjust volume and brightness.	Uninstall Apps, Clear App Data, install APKs from file.
App & System	List and launch installed apps, system reboot (normal, bootloader, recovery).	Improved app search and native menu integration.
Screen Mirroring	Full device screen mirroring with custom resolution.	Flex Display, Camera Torch & Zoom, Aspect Ratio Lock, Custom Background, Keep Active, Render Fit.
Productivity	Clipboard sync, command execution, file management.	Bi-directional Clipboard Sync (Mac/PC $leftrightarrow$ Android).

🛠️ Setup: Get Started in Minutes

AndroLaunch requires adb to communicate with Android devices. For screen mirroring features, scrcpy is also required.

macOS Installation

Requires macOS 15.3 (Sequoia) or later.

Option A — Homebrew (recommended)

brew install --cask aman-senpai/apps/androlaunch

This installs AndroLaunch.app to /Applications; dependencies (adb and scrcpy) are installed automatically if missing.

The tap-qualified name is the reliable form. After adding the tap (brew tap aman-senpai/apps) the short brew install --cask androlaunch works too, but it fails with “Cask androlaunch exists in multiple taps” when this repository is also tapped under its old name — in that case run brew untap aman-senpai/tap.

Homebrew 5+ asks you to trust a third-party tap the first time: accept the prompt, or run brew trust aman-senpai/apps (needed in scripts and on CI).

Note: the app is ad-hoc signed (not notarized), so macOS may refuse the first launch. Either right-click AndroLaunch in /Applications → Open, or run xattr -dr com.apple.quarantine /Applications/AndroLaunch.app.

Option B — Manual download

1. Launch: Download the macOS build (v<version>-macos.zip) from Releases, move AndroLaunch.app to Applications, and run.

2. Onboarding Wizard: On first launch, AndroLaunch guides you through dependency setup with an interactive onboarding window:
   • Automatically detects existing ADB and scrcpy installations
   • Offers one-click Install with Homebrew for missing dependencies
   • Shows real-time installation progress
   • Lets you skip and configure later via Settings

   Note: Requires scrcpy v4.0+ for all features.

3. Manual CLI Install (optional): Prefer the terminal?

   brew install --cask android-platform-tools
   brew install scrcpy
   

Windows Installation

1. Install ADB (required): We recommend using Scoop or Chocolatey:
   • Scoop: scoop install adb
   • Chocolatey: choco install adb
2. Install scrcpy (for screen mirroring): We recommend using Scoop or Chocolatey:
   • Scoop: scoop install scrcpy
   • Chocolatey: choco install scrcpy

   Note: Requires scrcpy v4.0+ for all features.

3. Launch: download AndroLaunch-0.3.9-windows-x64-setup.exe from Releases. The per-user installer requires no administrator privileges. Alternatively, extract all of v0.3.9-windows.zip and run AndroLaunch/AndroLaunch.WinUI.exe; do not move the executable out of that folder.

The Windows app uses WinUI 3: native navigation, menus, dialogs, system light/dark styling and a Mica backdrop. It includes device controls and mirroring configuration, app management and APK installation/export, a file browser, an Android emulator manager, QR/manual wireless pairing, saved commands, preferences and dependency onboarding. Android SDK command-line tools and the emulator are required only for AVD management; configure their paths in Settings. The native Windows title bar follows the same system app mode and updates live when Windows switches between light and dark.

The Windows 10 (1809+) / Windows 11 x64 packages include .NET and Windows App SDK; neither runtime needs a separate installation. The notification-area icon is the same monochrome Android mark as the macOS menu bar, embedded in light/dark variants. Windows may initially put it under Hidden icons; drag it onto the taskbar to pin it. Closing the main window leaves AndroLaunch running in the tray; choose Exit to quit.

Build on Windows: install the .NET 8 SDK, Visual Studio Windows App SDK/WinUI build prerequisites and Inno Setup 6. Then run:

dotnet build windows/AndroLaunch.WinUI/AndroLaunch.WinUI.csproj -c Release
./scripts/publish-windows.ps1 -Iscc 'C:/Program Files (x86)/Inno Setup 6/ISCC.exe'

Release outputs are written to build/windows/. The Windows release is unsigned; Windows SmartScreen may warn when launching it.

Linux Installation (KDE Plasma 6)

One command installs the dependencies, the androlaunch CLI and the Plasma panel widget, then adds the widget to your panel:

curl -fsSL https://raw.githubusercontent.com/aman-senpai/AndroLaunch/master/install.sh | bash

Requirements: KDE Plasma 6 (plasma-workspace). android-tools (adb), scrcpy and python3 are installed with your package manager (dnf, apt-get, pacman, zypper, apk) if they are missing. When the distro packages no scrcpy — Fedora 44 ships none, and RPM Fusion carries none either — the installer downloads the static x86_64 build from the scrcpy releases into ~/.local/share/scrcpy (checksum-verified against the release SHA256SUMS.txt, wrapper at ~/.local/bin/scrcpy); upstream publishes no Linux aarch64 build, so there scrcpy must be installed manually. Everything is user-local: backend at ~/.local/bin/androlaunch, widget at ~/.local/share/plasma/plasmoids/org.androlaunch.plasma. Uninstall with --uninstall.

Features on Linux:

• Native panel (menubar) widget: device/battery status, tabbed popup with quick toggles, mirroring, app manager, file browser, wireless pairing, ADB shell and AVD control
• Wireless pairing via QR code or 6-digit pairing code
• Full CLI (androlaunch devices|state|mirror|toggle|apps|files|shell|...)

See kde/README.md for details, CLI reference and troubleshooting.

Step 2: Configure Your Android Device

---

✨ Features In-Depth

📱 Device and System Management

Manage your device’s core functions directly from your Mac menu bar:

• Real-time Device List: See all connected Android devices and their status (e.g., Connected, Unauthorized).
• Quick Toggles: Instantly switch Wi-Fi, Bluetooth, Mobile Data, Location, and other critical system settings on or off.
• Power Controls: Easily Reboot your device into the System, Bootloader, or Recovery modes.
• Volume & Brightness: Adjust device volume and screen brightness sliders without touching your phone.

🔌 Seamless Connectivity

• Automatic Setup: AndroLaunch automatically discovers ADB from common install locations (Homebrew, Android Studio) and manages the ADB daemon.
• New! Wireless Pairing: Connect your Android device wirelessly to your Mac using a simple QR Code scan—no cables required after the initial setup.
• New! ADB Shell: Open a dedicated terminal for the selected device to execute custom ADB commands directly.

📂 App Control and Installation

Control your installed applications and manage APK files effortlessly:

• App List and Search: Browse all installed apps with a quick search function.
• Launch Apps: Open any app instantly from the menu.
• App Windows: Open an app in its own resizable window on a scrcpy virtual display. On Android 12–13 the app is instead opened on the mirrored screen (foreground), because the platform SystemUI crashes on such virtual displays and locks the device.
• New! App Uninstall: Remove unwanted apps with a confirmation dialog.
• New! Clear App Data: Reset an application to its initial state by clearing all its saved data.
• New! Install APK: Drag and drop or select an APK file to install it directly onto the connected device.

🖥️ Full Screen Mirroring (via Scrcpy)

Mirror your Android screen to your Mac with advanced options:

• Full Mirroring: Launch a window showing your device’s screen.
• Borderless Mode: For a cleaner, more integrated view.
• Camera Mirroring: Preview your device’s camera (front or back) in a separate window with custom FPS and resolution settings.
• Audio Toggle: Choose to mirror the audio from your device to your Mac.
• 🔒 Aspect Ratio Lock: Window automatically maintains device aspect ratio when resizing (disable with --no-aspect-ratio-lock).
• 🎨 Custom Background: Set any background color with hex code (e.g., --background-color=#234567). Default is now dark gray instead of black.
• 🔋 Keep Active: Prevent device sleep without changing global settings (--keep-active).
• 📐 Flex Display: Resize virtual display dynamically with the window (--flex-display / -x).
• 📸 Camera Torch & Zoom: Control camera flash (--camera-torch) and zoom level (--camera-zoom=1.5) for camera mirroring.
• 📏 Render Fit: Choose how content fits the window: contain, cover, fit-width, fit-height.
• 🔌 Disconnected Indicator: Shows a disconnect icon for 2 seconds before closing, so you know the connection dropped.

📋 Bi-directional Clipboard Sync

This is a massive productivity booster:

• Copy/Paste Mac $leftrightarrow$ Android: Text copied on your Mac is instantly available on your Android device, and vice-versa.
• Note: For Android $rightarrow$ Mac synchronization, you must install the companion app, AdbClipboard, on your Android device.

---

📸 Screenshots

         

License 📄

This project is licensed under the MIT License.

---

Powered By:

This site is open source. Improve this page.