Installation Guide

Select your device operating system to see the tailored setup steps and connection instructions.

Windows 10 / 11
Offline Installer
USB & Wi-Fi Bridges

On this page

File Type adb_devices.exe
01

System Requirements

Before launching the installer, verify that your computer meets the minimum hardware specifications:

  • Operating System Windows 10 or Windows 11 (64-bit architecture)
  • System Memory 1 GB RAM minimum (4 GB or more recommended for screen mirroring performance)
  • Connectivity Interfaces USB port for direct debugging, and Wi-Fi interface for local wireless connections
02

Installation Guide

  • Step 1: Download the Executable Get the latest version of adb_devices.exe from the GitHub Releases page or use our local Windows Download Hub.
  • Step 2: Run the Installer Double-click the downloaded adb_devices.exe file. If prompted by Windows SmartScreen, select "More info" and then click "Run anyway" to begin initialization.
  • Step 3: Allow Firewall Access During the first launch, the Windows Defender Firewall prompt will appear. Ensure you grant private network permission so the software can discover devices on your local Wi-Fi network.
ADB Device Manager operates 100% offline. The firewall permission is purely used to establish connection between your local computer and the Android companion app via your home network router.
03

USB Driver Configuration

If your connected Android phone is not showing up in the device list, you may need to install the manufacturer-specific USB drivers on your Windows PC.

Google USB Drivers

Universal fallback driver compatible with most Pixel, Nexus, and OEM devices.

Get Driver →

Samsung USB Drivers

Official USB serial drivers designed for Samsung Galaxy devices.

Get Driver →

OEM USB Directory

Android database listing setup rules and drivers for Xiaomi, Oppo, Vivo, and OnePlus.

Get Driver →
04

Common Fixes & Help

  • Device Not Detected? Make sure USB debugging is turned ON in Developer Options. See the Android setup tab for details.
  • Wi-Fi Sync Issues? Ensure both computer and phone are connected to the exact same Wi-Fi router network interface.
Android 7.0+
Companion APK
Zero Data Tracking

On this page

File Name companion.apk
01

Requirements

Verify that your Android device meets the configurations required to run the companion app:

  • Android OS Version Android 7.0 (API Level 24) or higher
  • Developer Permissions USB Debugging permission enabled (required for desktop communication client)
  • Battery Configuration Optimization disabled for companion client (highly recommended to maintain connection)
02

Download & Install

  • Step 1: Download the Package Download the companion app client, ADB_Device_Manager_Android_Installer.apk, directly via our official Android Download Hub.
  • Step 2: Allow Unknown Sources Navigate to Settings → Security and allow installation from unknown sources, or confirm the security prompt inside your browser or file manager.
  • Step 3: Run Setup Tap the downloaded APK inside your notification tray or downloads folder. Select "Install", wait for the package manager to finish, and open the app.
03

Enable USB Debugging

USB Debugging is required to authenticate the local secure ADB connection between your desktop machine and your mobile device.

  • Step 1: Activate Developer Menu Open Settings → About Phone, scroll down to find the Build Number, and tap it 7 times until a confirmation toast displays.
  • Step 2: Toggle USB Debugging Go back to Settings → System → Developer Options. Scroll to find USB Debugging and toggle it ON.
  • Step 3: Authorize PC connection Plug the device into your PC. Tap "Allow USB Debugging" on the popup. Select "Always allow from this computer" to enable automatic sync.
On certain OEM devices (such as Xiaomi, Redmi, Vivo, Oppo), you must also toggle "USB Debugging (Security Settings)" inside Developer Options to allow keyboard and touch inputs.
04

Background Reliability

To avoid sudden connection drops due to aggressive Android system battery management, configure these options for the companion app:

Samsung Systems

Settings → Battery & Device Care → Battery → Background usage limits → Add companion to "Never sleeping apps".

Xiaomi / MIUI

Settings → Apps → Manage Apps → Companion App → Battery Saver → Select "No restrictions". Ensure Autostart is active.

Oppo / Vivo / Realme

Settings → App Management → Companion App → Power Saver → Enable "Allow background activity" & "Auto-Start".

Google Pixel

Runs standard optimization natively. No special adjustments required under vanilla Android OS.

Ubuntu / Debian / Fedora
tar.gz Package
Local Performance

On this page

Archive Name linux_client.tar.gz
01

Requirements

Ensure your Linux box is updated and matches the following specifications:

  • Operating System Any modern 64-bit GNU/Linux distribution (Ubuntu 20.04+, Debian 11+, Fedora 36+, Arch Linux)
  • Prerequisites Installed libraries: libudev, glibc 2.31+, and package adb (Android Platform Tools)
02

Setup Steps

  • Step 1: Download the Tarball Get ADB_Device_Manager_Linux.tar.gz from our GitHub releases page or the official mirrors.
  • Step 2: Extract & Navigate Open a terminal and extract the tarball, then navigate into the extracted directory: 
    tar -xzf ADB_Device_Manager_Linux.tar.gz
cd adb_devices
  • Step 3: Grant Script Execution Permission Enable execution permission on the launch script: 
    chmod +x run_adb_devices.sh
  • Step 4: Execute the Script Run the application using the setup shell script: 
    ./run_adb_devices.sh
03

Udev Configuration (USB Access)

To connect to USB devices as a non-root user, ensure your account belongs to the plugdev user group and your system has default Android udev rules established.

  • Step 1: Add User to Plugdev Group Execute the following group assignment command: 
    sudo usermod -aG plugdev $USER
  • Step 2: Reload Rules Restart the udev daemon to load configuration changes: 
    sudo udevadm control --reload-rules
Log out and log back in to apply your new user group permissions successfully.
macOS Client
Under Development
Intel / Apple Silicon

On this page

Release Status Coming Soon
01

Development Status

We are actively working on a fully native macOS client for ADB Device Manager. The app is being optimized for both Intel chips and Apple Silicon (M1/M2/M3) architectures using hardware acceleration protocols.

Key features in development for macOS include:

  • Metal-Accelerated Screen Mirroring Lag-free stream renders with dynamic scaling directly optimized for Retina displays.
  • CoreAudio Bridge integration Seamless system audio streaming from target devices using native CoreAudio pipelines.
02

Track Progress & Contributions

Watch and star our GitHub repository to track progress updates and get immediate alerts when the official macOS package is released.

Star Repository on GitHub