scrcpy

1 Installation

scrcpy is a free, open-source tool that mirrors and controls your Android device from a computer. Install it using your preferred method:

Windows

WinGet (recommended): winget install --exact Genymobile.scrcpy
Chocolatey: choco install scrcpy
Scoop: scoop install scrcpy
Manual: download the latest release and extract the ZIP.

Linux

Arch Linux: pacman -S scrcpy
Fedora: dnf copr enable zeno/scrcpy && dnf install scrcpy
Debian/Ubuntu: build from source using the install script (the apt version is outdated).
Snap: snap install scrcpy (may be outdated).

macOS

Homebrew (recommended): brew install scrcpy
MacPorts: sudo port install scrcpy
Manual: download the latest release and extract the tar.gz.

2 Screen Mirroring

Connect your device via USB and run scrcpy to mirror the screen:

scrcpy

For better quality and performance, try:

scrcpy --video-codec=h265 --max-size=1920 --max-fps=60 --no-audio

Audio forwarding requires Android 11+ (API 30). To disable audio:

scrcpy --no-audio

You can control the device with your computer's keyboard and mouse. Right-click triggers BACK, middle-click triggers HOME, and Alt+F toggles fullscreen.

3 Virtual Display (Desktop/Gaming)

scrcpy can create a virtual display instead of mirroring the physical screen. When combined with Kwiq, this triggers Desktop Mode or Gaming Mode depending on your Kwiq configuration. This is the recommended way to use Kwiq on a big screen.

scrcpy --new-display=1920x1080

Desktop Mode:

scrcpy --new-display=1920x1080 --start-app=com.redclaw.kwiq/.desktop.DesktopActivity

Gaming Mode:

scrcpy --new-display=1920x1080 --start-app=com.redclaw.kwiq/.gaming.GamingActivity

Flex Display

Use --flex-display (or -x) to resize the virtual display to match the scrcpy window:

scrcpy --new-display=1920x1080 --flex-display --keep-active

No System Decorations

Use --no-vd-system-decorations to disable the default launcher UI in the virtual display, useful when launching a specific app:

scrcpy --new-display=1920x1080 --no-vd-system-decorations --start-app=com.redclaw.kwiq/.desktop.DesktopActivity

Keep Apps on Close

By default, apps are destroyed when the virtual display closes. Use --no-vd-destroy-content to move them to the main display instead:

scrcpy --new-display --no-vd-destroy-content

4 OTG Mode

OTG mode lets you control the device using a physical keyboard, mouse, or gamepad connected to your computer, as if they were plugged directly into the Android device via an OTG cable. No USB debugging required!

scrcpy --otg

To also enable gamepad support:

scrcpy --otg --gamepad=aoa

To disable keyboard (mouse only):

scrcpy --otg --keyboard=disabled

To disable mouse (keyboard only):

scrcpy --otg --mouse=disabled

5 Wireless Connection

You can connect wirelessly over Wi-Fi. First, connect via USB and enable TCP/IP mode:

scrcpy --tcpip

This automatically finds the device IP and enables wireless mode.

Manual Setup

If the device already listens on TCP/IP (e.g., after adb tcpip 5555):

scrcpy --tcpip=192.168.1.1

6 Tips and Shortcuts