Display and control your Android device
Document launchers in virtual displays
Romain Vimontb26b4fb7458b
diff --git a/doc/virtual_display.md b/doc/virtual_display.mdindex 7523c118..5036f35b 100644--- a/doc/virtual_display.md+++ b/doc/virtual_display.md@@ -15,8 +15,10 @@ scrcpy --new-display=/240 # use the main display size and 240 dpiOn some devices, a launcher is available in the virtual display.-When no launcher is available, the virtual display is empty. In that case, you-must [start an Android app](device.md#start-android-app).+When no launcher is available (or if is explicitly disabled by+[`--no-vd-system-decorations`](#system-decorations)), the virtual display is+empty. In that case, you must [start an Android+app](device.md#start-android-app).For example:@@ -24,12 +26,27 @@ For example:scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc```+The app may itself be a launcher. For example, to run the open source [Fossify+Launcher]:++```bash+scrcpy --new-display=1920x1080 --no-vd-system-decorations --start-app=org.fossify.home+```++[Fossify Launcher]: https://f-droid.org/en/packages/org.fossify.home/++## System decorations-By default, virtual display system decorations are enabled. But some devices-might display a broken UI;+By default, virtual display system decorations are enabled. To disable them, use+`--no-vd-system-decorations`:++```+scrcpy --new-display --no-vd-system-decorations+```-Use `--no-vd-system-decorations` to disable it.+This is useful for some devices which might display a broken UI, or to disable+any default launcher UI available in virtual displays.Note that if no app is started, no content will be rendered, so no video framewill be produced at all.