scrcpy buddy is a clean, minimalist Flutter-based desktop application that provides an intuitive graphical interface for scrcpy, the popular Android screen mirroring and control tool. Built with Fluent UI design principles, it brings a polished, native desktop experience to managing your Android devices across Windows, Linux, and macOS.

Requirements

To use this app, you need the following:

• adb (in $PATH or in portable mode)
• scrcpy (in $PATH or in portable mode)
• Android device(s) with "Developer options" and USB / Network debugging enabled: https://developer.android.com/tools/adb#Enabling

Features

• Run scrcpy on multiple connected devices
• ADB Device management (Switch USB Device to network / disconnect device)
  • Auto-refresh devices list
• Profile management (name, customized scrcpy options, default profile)
• Light / Dark theme support
• View console output for devices which are running scrcpy
• Search through all scrcpy options
• Convenient app selection for starting an app with scrcpy from a connected device
• Close app to tray

Coming next

See milestones

Supported languages

• Only English for now

But the app is built with i18n in mind. So, support for more languages can be added gradually.

Screenshots

(may not be up-to-date)

Screenshots	Screenshots	Screenshots

Download & Installation

All downloads can be found on the latest release page

Supported and tested platforms

OS	Minimum Supported	Tested ✅
MacOS	11 Big Sur	26 Tahoe
Windows	7 (?)	11
Linux	Should work on all versions	KUbuntu 25.10

Installation

MacOS

🍺 Homebrew

• brew tap Codertainment/scrcpy_buddy
  • The tap source is available here
• brew install scrcpy_buddy

Installing from DMG

• Download and open the DMG File
• Make sure you have administrator privileges
• Drag and drop the app icon to "Applications" folder
• Open the app by searching for it (⌘ Space)
• See the next section to understand how to open the app

Opening the app on MacOS

For macOS apps to be verified, a developer account is required, which has a membership fee of $99/year. As this is my personal project, I cannot afford this.

Hence, the app is unverified, and it requires manual intervention to open it for the first time.

Follow the instructions from Apple Support to manually override the signing and check and open the app.

Linux

Possible installation options:

Snap

• Install from the Snap Store (Recommended for automatic updates)

Manual installation:

• Download and install the snap:
• $sudo snap install scrcpy-buddy_<version>_amd64.snap --dangerous
• Connect the snap to the necessary interfaces:
• $sudo snap connect scrcpy-buddy:scrcpy-runtime-2404 scrcpy-runtime:2404:scrcpy-runtime:2404
• $ sudo snap connect scrcpy-buddy:gnome-46-2404 gnome-46-2404:gnome-46-2404

AppImage

• Download and open the AppImage

Windows

Possible installation options:

• Install directly from Microsoft Store (Recommended for automatic updates)
• Install via EXE Setup

Usage instructions

Running scrcpy

Once you have everything setup, connected Android devices (through ADB) should show up in the homepage (known as " Devices").

The app also shows the device status and the serial number.

To run scrcpy on your device(s):

• Select available device(s)
• Configure scrcpy options as you wish by navigating to the categories
• Click on "Start" at the top right corner

Customizing scrcpy options

• Simply navigate to the desired category from the navigation drawer
• Change the options as you'd like
• All changes are saved automatically to the currently selected profile (visible in the dropdown button at top right)

Profile management

A profile contains:

1. Name
2. Customized scrcpy options

You can create, rename and delete profiles from the "Manage profiles" page.

The dropdown button at the top indicates the currently active profile.

By clicking on the dropdown button, you can switch between profiles, create a new profile or navigate to the profile management page.

Configuring a default profile

You can choose a single profile to be the default one (everytime you open the app), or let the last used profile be the default one.

To configure a specific profile as the default one, either:

• Go to the profile management page, and set it as default by clicking the overflow menu button (...)
• Go to settings, under the "Default profile" section, select a profile

To default to the last used profile:

• Go to settings, under the "Default profile" section, select "Last used" from the dropdown menu

Troubleshooting

ADB / scrcpy not found

If you have ADB and/or scrcpy setup and installed in your path:

• Depending on the platform, the app may not be able to find ADB / scrcpy in the path. You can set the executable in settings manually.
• To find out the installation path, run this command in the terminal:
• e.g.
  • For Windows: where adb
  • For MacOS/Linux: which adb

Setting executable path manually in settings

For adb and/or scrcpy: paste the full executable path in the textbox. (e.g. /opt/homebrew/bin/adb)

Verify that the app is able to access the executables by clicking on "Check".

It should show the adb or scrcpy version.

How it works

scrcpy buddy functions as a graphical user interface (GUI) wrapper for command-line tools. The application does not communicate directly with Android devices or access device data itself. Instead, it exclusively interacts with adb and scrcpy. All device communication and data processing occur through these external tools, which operate under their own respective privacy policies and security models.

List of commands used by the app

ADB Commands

• adb --version - Retrieves the installed adb version
• adb track-devices - To auto-refresh list of connected Android devices
• adb devices -l - Lists connected Android devices
• adb start-server - Starts the ADB server process
• adb connect - Connects to Android devices over network
• adb disconnect - Disconnects from network-connected devices
• adb shell ip route show - Retrieves network routing information from connected devices
• adb tcpip - Switches device connection mode to TCP/IP

scrcpy Commands

• scrcpy - Launches screen mirroring with user-configured options from the application UI
• scrcpy --version - Retrieves the installed scrcpy version
• scrcpy --list-apps - Lists applications installed on connected devices

License

Apache-2.0: See LICENSE

Artworks credits

The Android robot is reproduced or modified from work created and shared by Google and used according to terms described in the Creative Commons 3.0 Attribution License (https://creativecommons.org/licenses/by/3.0/).

Thanks to my friend, @SudipRajbanshi for creating the beautiful logo, banner and tray icon ❤️