From 32d6a19aca7aa103db0ce2cc89bd7ff2dea26304 Mon Sep 17 00:00:00 2001 From: Romain Vimont Date: Sat, 18 Apr 2026 11:34:49 +0200 Subject: [PATCH] Document render fit --- doc/window.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/doc/window.md b/doc/window.md index 2bc13b47..ee1659e3 100644 --- a/doc/window.md +++ b/doc/window.md @@ -69,3 +69,25 @@ computer. To disable it: ```bash scrcpy --disable-screensaver ``` + + +## Render fit + +By default, the video stream is rendered in [letterbox] mode: the content fits +the window as best as possible while preserving the aspect ratio. + +For [flex displays], the display is continuously resized to match the window, so +render fit is _disabled_: the content is rendered at the top-left corner, +without scaling. + +It is also possible to _stretch_ the content to fit the window without +preserving aspect ratio (`--render-fit=stretched`). + +```bash +scrcpy --render-fit=letterbox # default +scrcpy --render-fit=disabled # default for flex displays +scrcpy --render-fit=stretched +``` + +[letterbox]: https://en.wikipedia.org/wiki/Letterboxing_(filming) +[flex displays]: virtual_display.md#flex-display