Installation

Installation

Requirements

• Android device running Android 5.0 or higher (Android 12+ for Camera mode, Android 11+ for Desktop mode)
• A high-quality USB data cable (avoid charging-only cables)
• PC running Windows, macOS, or Linux
• Core binaries: the app can download these for you automatically, or you can provide your own

Windows

1. Download the latest .exe or .msi from the Releases page.
2. Run the installer or standalone executable.
3. Smart setup: on the first launch, OpenScrcpy detects whether the core binary is installed. If not, it offers a one-click download.
4. Automatic updates: on launch, OpenScrcpy checks your installed version against the latest official release and offers a one-click update when a new version exists.

macOS

1. Download the .dmg file matching your architecture (Intel or Apple Silicon/M1/M2).
2. Drag the OpenScrcpy icon into your Applications folder.
3. Security note: since the app is not signed by Apple, you may need to go to System Settings > Privacy & Security, scroll to "Security" and click Open Anyway.

Linux

1. Download the .AppImage or .deb package.
2. AppImage: right-click the file, open Properties, go to Permissions and select Allow executing file as program. Then double-click to run.
3. Dependencies: if you hit issues, install the system libraries:

   sudo apt install libgtk-3-dev libwebkit2gtk-4.1-dev

Android device setup

You must enable Developer Options and USB Debugging on your phone.

1. Open Settings on your Android device.
2. Go to About Phone (usually at the bottom).
3. Find the Build Number and tap it 7 times rapidly. You will see a toast: "You are now a developer!"
4. Go back to Settings, then System > Developer Options (or search for it).
5. Toggle ON USB Debugging.
6. If you see options like Install via USB or USB Debugging (Security Settings) (needed for mice/keyboards), enable them too.

Connecting

USB (recommended): plug the phone into the PC, accept the "Allow USB Debugging?" prompt on the phone (check "Always allow from this computer"), then click Refresh in the header if the device does not appear.

Wireless (Android 11+): put phone and PC on the same Wi-Fi, enable Wireless Debugging in Developer Options, open its settings, then click Wireless Connect in the sidebar and enter the IP address, port, and pairing code shown on the phone. Once paired, OpenScrcpy remembers the device for one-click connections.