Genymobile-scrcpy/doc/window.md
Tech-Tac 65153a09c3 Add option to disable window aspect ratio lock
By default, the window aspect ratio is preserved when resizing.

Add `--no-window-aspect-ratio-lock` to disable this behavior.

PR #6761 <https://github.com/Genymobile/scrcpy/pull/6761>

Signed-off-by: Romain Vimont <rom@rom1v.com>
2026-04-10 19:35:43 +02:00

1.2 KiB

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

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 (see shortcuts).

Disable screensaver

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

scrcpy --disable-screensaver