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.
To use this app, you need the following:
- adb (in
$PATHor in portable mode) - scrcpy (in
$PATHor in portable mode) - Android device(s) with "Developer options" and USB / Network debugging enabled: https://developer.android.com/tools/adb#Enabling
- Run scrcpy on multiple connected devices
- ADB Device management (Switch USB Device to network / disconnect device)
- Profile management (name, customized scrcpy options, default profile)
- Light / Dark theme support
- View console output for devices which are running scrcpy
- Convenient app selection for starting an app with scrcpy from a connected device
- Close app to tray
See milestones
- Only English for now
But the app is built with i18n in mind. So, support for more languages can be added gradually.
(may not be up-to-date)
| Screenshots | Screenshots | Screenshots |
|---|---|---|
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
All downloads can be found on the latest release page
| OS | Minimum Supported | Tested ✅ |
|---|---|---|
| MacOS | 11 Big Sur | 26 Tahoe |
| Windows | 7 (?) | 11 |
| Linux | Should work on all versions | KUbuntu 25.10 |
brew tap Codertainment/scrcpy_buddy- The tap source is available here
brew install scrcpy_buddy
- 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
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.
Possible installation options:
- Install from Snap Store (coming soon)
- Download and install the snap manually (
$ sudo snap install <file_name>.snap --classic --dangerous) - Download and open the AppImage
Possible installation options:
- Install directly from Microsoft Store (Recommended for automatic updates)
- Install via EXE Setup
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
- 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)
A profile contains:
- Name
- 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.
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
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
- For Windows:
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.
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.
adb --version- Retrieves the installed adb versionadb track-devices- To auto-refresh list of connected Android devicesadb devices -l- Lists connected Android devicesadb start-server- Starts the ADB server processadb connect- Connects to Android devices over networkadb disconnect- Disconnects from network-connected devicesadb shell ip route show- Retrieves network routing information from connected devicesadb tcpip- Switches device connection mode to TCP/IP
scrcpy- Launches screen mirroring with user-configured options from the application UIscrcpy --version- Retrieves the installed scrcpy versionscrcpy --list-apps- Lists applications installed on connected devices
Apache-2.0: See LICENSE
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 ❤️