Skip to content
Scrcpy logo Scrcpy

Install and run scrcpy on Linux

From the official release

Section titled “From the official release”

Download a static build of the latest release:

and extract it.

Static builds of scrcpy for Linux are still experimental.

From your package manager

Section titled “From your package manager”

Packaging status

Scrcpy is packaged in several distributions and package managers:

  • Debian/Ubuntu: apt install scrcpy (obsolete version)
  • Arch Linux: pacman -S scrcpy
  • Fedora: dnf copr enable zeno/scrcpy && dnf install scrcpy
  • Gentoo: emerge scrcpy
  • Snap: snap install scrcpy (obsolete version)
  • … (see repology)

From an install script

Section titled “From an install script”

To install the latest release from master, follow this simplified process.

First, you need to install the required packages:

Terminal window
# for Debian/Ubuntu
sudo apt install ffmpeg libsdl2-2.0-0 adb wget \
                 gcc git pkg-config meson ninja-build libsdl2-dev \
                 libavcodec-dev libavdevice-dev libavformat-dev libavutil-dev \
                 libswresample-dev libusb-1.0-0 libusb-1.0-0-dev

Then clone the repo and execute the installation script (source):

Terminal window
git clone https://github.com/Genymobile/scrcpy
cd scrcpy
./install_release.sh

When a new release is out, update the repo and reinstall:

Terminal window
git pull
./install_release.sh

To uninstall:

Terminal window
sudo ninja -Cbuild-auto uninstall

Note that this simplified process only works for released versions (it downloads a prebuilt server binary), so for example you can’t use it for testing the development branch (dev).

See build.md to build and install the app manually.

Run

Section titled “Run”

Make sure that your device meets the prerequisites.

Once installed, run from a terminal:

Terminal window
scrcpy

or with arguments (here to disable audio and record to file.mkv):

Terminal window
scrcpy --no-audio --record=file.mkv

Documentation for command line arguments is available: