Go to file
Romain Vimont acd2dc3183 Shutdown sockets before closing
The server socket does not release the port it was listening for if we
just close it: we must also shutdown it.
2018-03-07 18:04:39 +01:00
app Shutdown sockets before closing 2018-03-07 18:04:39 +01:00
assets Update README 2018-03-07 18:04:38 +01:00
config Apply Genymobile rules for Android projects 2018-02-07 20:58:18 +01:00
gradle/wrapper Convert server to an Android project 2018-01-30 12:01:36 +01:00
scripts Rename SCRCPY_SERVER_JAR to SCRCPY_SERVER_PATH 2018-02-16 15:36:25 +01:00
server Double the default bitrate 2018-03-07 18:04:38 +01:00
.gitignore Convert server to an Android project 2018-01-30 12:01:36 +01:00
build.gradle Convert server to an Android project 2018-01-30 12:01:36 +01:00
gradle.properties Convert server to an Android project 2018-01-30 12:01:36 +01:00
gradlew Convert server to an Android project 2018-01-30 12:01:36 +01:00
gradlew.bat Convert server to an Android project 2018-01-30 12:01:36 +01:00
LICENSE Add Apache 2 LICENSE file 2018-02-28 17:02:15 +01:00
Makefile Add missing .PHONY in portable Makefile 2018-02-16 15:36:25 +01:00
meson_options.txt Rename SCRCPY_SERVER_JAR to SCRCPY_SERVER_PATH 2018-02-16 15:36:25 +01:00
meson.build Require Meson 0.37 2018-02-14 14:03:56 +01:00
README.md Double the default bitrate 2018-03-07 18:04:38 +01:00
run Rename SCRCPY_SERVER_JAR to SCRCPY_SERVER_PATH 2018-02-16 15:36:25 +01:00
settings.gradle Convert server to an Android project 2018-01-30 12:01:36 +01:00

scrcpy

This project displays screens of Android devices connected on USB, and allow to control them using the host mouse and keyboard. It does not require any root access. It works on GNU/Linux, Windows and Mac OS.

screenshot

Requirements

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

You need adb (recent enough so that adb reverse is implemented, it works with 1.0.36). It is available in the Android SDK platform tools, on packaged in your distribution (android-adb-tools).

On Windows, just download the platform-tools and extract the following files to a directory accessible from your PATH:

  • adb.exe
  • AdbWinApi.dll
  • AdbWinUsbApi.dll

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

The client requires FFmpeg and LibSDL2.

Build and install

System-specific steps

Linux

Install the required packages from your package manager (here, for Debian):

# runtime dependencies
sudo apt install ffmpeg libsdl2-2.0.0

# build dependencies
sudo apt install make gcc openjdk-8-jdk pkg-config meson zip \
                 libavcodec-dev libavformat-dev libavutil-dev \
                 libsdl2-dev

Windows

For Windows, for simplicity, a prebuilt package with all the dependencies (including adb) is available: TODO.

Instead, you may want to build it manually. You need MSYS2 to build the project. From an MSYS2 terminal, install the required packages:

# runtime dependencies
pacman -S mingw-w64-x86_64-SDL2 \
          mingw-w64-x86_64-ffmpeg

# build dependencies
pacman -S mingw-w64-x86_64-make \
          mingw-w64-x86_64-gcc \
          mingw-w64-x86_64-pkg-config \
          mingw-w64-x86_64-meson \
          zip

Java (>= 7) is not available in MSYS2, so if you plan to build the server, install it manually and make it available from the PATH:

export PATH="$JAVA_HOME/bin:$PATH"

Mac OS

Use Homebrew to install the packages:

# runtime dependencies
brew install sdl2 ffmpeg

# build dependencies
brew install gcc pkg-config meson zip

Java (>= 7) is not available in Homebrew, so if you plan to build the server, install it manually and make it available from the PATH:

export PATH="$JAVA_HOME/bin:$PATH"

Common steps

Install the Android SDK (Android Studio), and set ANDROID_HOME to its directory. For example:

export ANDROID_HOME=~/android/sdk

Then, build scrcpy:

meson x --buildtype release --strip -Db_lto=true
cd x
ninja

You can test it from here:

ninja run

Or you can install it on the system:

sudo ninja install    # without sudo on Windows

This installs two files:

  • /usr/local/bin/scrcpy
  • /usr/local/share/scrcpy/scrcpy-server.jar

Just remove them to "uninstall" the application.

Prebuilt server

Since the server binary, that will be pushed to the Android device, does not depend on your system and architecture, you may want to use the prebuilt binary instead: scrcpy-server.jar.

In that case, the build does not require Java or the Android SDK.

Download the prebuilt server somewhere, and specify its path during the Meson configuration:

meson x --buildtype release --strip -Db_lto=true \
    -Dprebuilt_server=/path/to/scrcpy-server.jar
cd x
ninja
sudo ninja install

Run

At runtime, adb must be accessible from your PATH.

If everything is ok, just plug an Android device, and execute:

scrcpy

It accepts command-line arguments, listed by:

scrcpy --help

For example, to decrease video bitrate to 2Mbps (default is 8Mbps):

scrcpy -b 2M

To limit the video dimensions (e.g. if the device is 2540×1440, but the host screen is smaller, or cannot decode such a high definition):

scrcpy -m 1024

If several devices are listed in adb devices, you must specify the serial:

scrcpy -s 0123456789abcdef

Shortcuts

Action Shortcut
switch fullscreen mode Ctrl+f
resize window to 1:1 (pixel-perfect) Ctrl+g
resize window to remove black borders Ctrl+x
click on HOME Ctrl+h
click on BACK Ctrl+b
click on APP_SWITCH Ctrl+m
click on VOLUME_UP Ctrl++
click on VOLUME_DOWN Ctrl+-
click on POWER Ctrl+p
turn screen on Right-click
enable/disable FPS counter (on stdout) Ctrl+i

Licence

Copyright (C) 2018 Genymobile

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.