From a9633b3361ba4e05e10109234379a3df371b83fd Mon Sep 17 00:00:00 2001
From: Romain Vimont <rom@rom1v.com>
Date: Fri, 17 Apr 2026 22:36:02 +0200
Subject: [PATCH] Document flex display

---
 doc/virtual_display.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/doc/virtual_display.md b/doc/virtual_display.md
index 9f962127..3f8e87da 100644
--- a/doc/virtual_display.md
+++ b/doc/virtual_display.md
@@ -13,6 +13,24 @@ scrcpy --new-display=/240    # use the main display size and 240 dpi
 
 The new virtual display is destroyed on exit.
 
+
+## Flex display
+
+To continuously resize the virtual display to match the window size, enable
+"flex display" using `--flex-display` (or `-x`):
+
+```bash
+# Start Android Settings in a window
+scrcpy --new-display=1024x768 --start-app=com.android.settings --flex-display
+
+# -x is equivalent to --flex-display
+scrcpy --new-display=1024x768 --start-app=com.android.settings -x
+
+# By default, the display size/dpi is 1280x960/160
+scrcpy --new-display --start-app=com.android.settings --flex-display
+```
+
+
 ## Start app
 
 On some devices, a launcher is available in the virtual display.