You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Romain Vimont f1b2d6bbbb Bump version to 2.0 1 year ago
.github/ISSUE_TEMPLATE Improve bug report template 4 years ago
app Bump version to 2.0 1 year ago
assets Update README 6 years ago
config Upgrade Android checkstyle to 9.0.1 3 years ago
doc Rework README and documentation 1 year ago
gradle/wrapper Upgrade gradle build tools to 7.4.0 1 year ago
scripts Use portable shebang for all bash scripts 4 years ago
server Bump version to 2.0 1 year ago
.gitignore Add local.properties to gitignore 4 years ago
FAQ.md Merge branch 'master' into dev 1 year ago
LICENSE Happy new year 2023! 1 year ago
README.md Rework README and documentation 1 year ago
build.gradle Upgrade gradle build tools to 7.4.0 1 year ago
bump_version Add script to bump version 2 years ago
cross_win32.txt Upgrade SDL (2.26.4) for Windows 1 year ago
cross_win64.txt Upgrade SDL (2.26.4) for Windows 1 year ago
gradle.properties Enable video output file, with pts set by server 6 years ago
gradlew Update to Gradle 6.3 4 years ago
gradlew.bat Update to Gradle 6.3 4 years ago
install_release.sh Use "meson setup" from install_release.sh 1 year ago
meson.build Bump version to 2.0 1 year ago
meson_options.txt Add compilation flag for USB features 2 years ago
release.mk Upgrade platform-tools (34.0.1) for Windows 1 year ago
release.sh Rename release.make to release.mk 3 years ago
run Fix icon path in ./run 2 years ago
settings.gradle Convert server to an Android project 6 years ago

README.md

scrcpy (v1.25)

scrcpy

pronounced "screen copy"

This application mirrors Android devices (video and audio) connected via USB or over TCP/IP, and allows to control the device with the keyboard and the mouse of the computer. It does not require any root access. It works on Linux, Windows and macOS.

screenshot

It focuses on:

  • lightness: native, displays only the device screen
  • performance: 30~120fps, depending on the device
  • quality: 1920×1080 or above
  • low latency: 35~70ms
  • low startup time: ~1 second to display the first image
  • non-intrusiveness: nothing is left installed on the Android device
  • user benefits: no account, no ads, no internet required
  • freedom: free and open source software

Its features include:

Requirements

The Android device requires at least API 21 (Android 5.0).

Audio forwarding is supported from API 30 (Android 11).

Make sure you enabled adb debugging on your device(s).

On some devices, you also need to enable an additional option USB debugging (Security Settings) (this is an item different from USB debugging) to control it using a keyboard and mouse.

Get the app

User documentation

The application provides a lot of features and configuration options. They are documented in the following pages:

Resources

Articles

Contact

If you encounter a bug, please read the FAQ first, then open an issue.

For general questions or discussions, you can also use:

Donate

I'm @rom1v, the author and maintainer of scrcpy.

If you appreciate this application, you can support my open source work.

Licence

Copyright (C) 2018 Genymobile
Copyright (C) 2018-2023 Romain Vimont

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.