Brief: This guide shows how to install scrcpy an application that helps you connect, display and control an android device from your Linux desktop computer.

Scrcpy (pronounced “screen copy“) is a free, open-source, and cross-platform utility used to display and control an Android device from your Linux desktop. It functions on Linux, Windows, and macOS, and enables control of a device connected either via USB or over a network (TCP/IP).

Its features include screen mirroring with the device's screen turned off, adjustable screen resolution, video recording, bidirectional copy-paste support, using an Android device as a webcam (Linux only), simulated keyboard and mouse input, OTG mode, and more.

To run scrcpy, your Android device must be running at least API 21 (Android 5.0), and have adb (Android Debug Bridge) debugging enabled (USB debugging). However, it does not require root access on the Linux side.

Install Scrcpy on Linux Systems

On Debian-based systems such as Ubuntu and Linux Mint, install scrcpy directly from the default repositories by running:

<code>$ sudo apt install scrcpy</code>

For Fedora, enable the Cool Other Packages Repository (COPR) first and then install scrcpy:

<code>$ sudo dnf copr enable zeno/scrcpy
$ sudo dnf install scrcpy</code>

Users of Arch Linux can install scrcpy with this command:

<code># pacman -S scrcpy</code>

Alternatively, scrcpy is available as a snap package. For RHEL-based distributions, use these commands to install it:

<code>$ sudo yum install snapd
$ sudo systemctl enable --now snapd.socket
$ sudo ln -s /var/lib/snapd/snap /snap
$ sudo snap install scrcpy</code>

Connect to An Android Device via USB in Linux

Once installed, ensure USB debugging is enabled on your Android device (Settings=>Developer Options=>USB debugging), then connect the device to your Linux machine using a USB cable.

A prompt should appear on your Android device asking for authorization to allow USB debugging from the computer — tap Allow to continue.

Now launch scrcpy from the terminal:

<code>$ scrcpy</code>

If everything works correctly, a window will appear showing your Android device’s screen, like in the image below.

Connect to Android Device via Wifi in Linux Desktop

Start by installing the adb command-line tool if you haven't already:

<code>$ sudo apt install adb         [On <strong>Debian, Ubuntu and Mint</strong>]
$ sudo yum install adb         [On <strong>RHEL/CentOS/Fedora</strong> and <strong>Rocky Linux/AlmaLinux</strong>]
$ sudo pacman -S adb           [On <strong>Arch Linux</strong>]</code>

Once adb is installed, make sure both your computer and Android device are connected to the same Wi-Fi network. Then connect your Android device to your computer via USB.

Next, disconnect the USB cable and check the IP address of your Android device (via Settings –> Connections –> Wi-Fi –> tap on connected network) or retrieve it using the following command:

<code>$ adb shell ip route</code>

Set your Android device to listen on port 5555 for TCP/IP connections:

<code>$ adb tcpip 5555</code>

Then connect to the device wirelessly using its IP address:

<code>$ adb connect 192.168.1.4:5555</code>

Finally, start scrcpy to begin mirroring the Android screen on your Linux desktop:

<code>$ scrcpy</code>

Scrcpy Command Examples with Options

As seen in the screenshots above, scrcpy uses the device model name as the window title by default. You can customize this with the --window-title option, as shown below (replace ‘My device‘ with your preferred title):

<code>$ scrcpy  --window-title='My device'</code>

To adjust the size of the mirrored screen, use the --max-size or -m parameter:

<code>$ scrcpy -m 1024
OR
$ scrcpy --max-size=1024</code>

Screen recording during mirroring is supported via the --record or -r flag:

<code>$ scrcpy -r filename.mp4</code>

To record without displaying the screen, use the --no-display or -N option:

<code>$ scrcpy -Nr filename.mp4</code>

Press Ctrl C to stop the recording process.

You can also change the bit rate from the default 8 Mbps using the --bit-rate or -b switch:

<code>$ scrcpy -b 4M</code>

There are many additional command-line options available. To view them all, run:

<code>$ scrcpy --help</code>

Lastly, note that certain Android devices may require enabling extra settings to fully support keyboard and mouse control. For further details, refer to the scrcpy GitHub repository.

The above is the detailed content of Scrcpy - Control Your Android Device via Linux Desktop. For more information, please follow other related articles on the PHP Chinese website!