scrcpy/doc/window.md

Window

Disable window

To disable window (may be useful for recording or for playing audio only):

scrcpy --no-window --record=file.mp4
# Ctrl+C to interrupt

Title

By default, the window title is the device model. It can be changed:

scrcpy --window-title='My device'

Position and size

The initial window position and size may be specified:

scrcpy --window-x=100 --window-y=100 --window-width=800 --window-height=600

By default, the window aspect ratio is preserved when resizing. To disable this behavior:

scrcpy --no-window-aspect-ratio-lock

Background color

To maintain the device aspect ratio (when using --no-window-aspect-ratio-lock or in fullscreen mode), padding is added around the device. By default, it is dark gray (#222).

This can be changed:

# Use the hexadecimal color code #234567
# (r, g, b) = (0x23, 0x45, 0x67) = (35, 69, 103)
scrcpy --fullscreen --background-color=#234567

# The leading '#' is optional
scrcpy --fullscreen --background-color=234567

# Hexadecimal color shorthand (3-digit form) is supported
scrcpy --fullscreen --background-color=#567
# is equivalent to:
scrcpy --fullscreen --background-color=#556677

Borderless

To disable window decorations:

scrcpy --window-borderless

Always on top

To keep the window always on top:

scrcpy --always-on-top

Fullscreen

The app may be started directly in fullscreen:

scrcpy --fullscreen
scrcpy -f   # short version

Fullscreen mode can then be toggled dynamically with MOD+f or F11 (see shortcuts).

Disable screensaver

By default, scrcpy does not prevent the screensaver from running on the computer. To disable it:

scrcpy --disable-screensaver