Skip to content

Commit b26b4fb

Browse files
committed
Document launchers in virtual displays
Mention how to start a launcher in a virtual display. Refs #5592 <#5592>
1 parent 9555d3a commit b26b4fb

File tree

1 file changed

+22
-5
lines changed

1 file changed

+22
-5
lines changed

doc/virtual_display.md

Lines changed: 22 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,21 +15,38 @@ scrcpy --new-display=/240 # use the main display size and 240 dpi
1515

1616
On some devices, a launcher is available in the virtual display.
1717

18-
When no launcher is available, the virtual display is empty. In that case, you
19-
must [start an Android app](device.md#start-android-app).
18+
When no launcher is available (or if is explicitly disabled by
19+
[`--no-vd-system-decorations`](#system-decorations)), the virtual display is
20+
empty. In that case, you must [start an Android
21+
app](device.md#start-android-app).
2022

2123
For example:
2224

2325
```bash
2426
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
2527
```
2628

29+
The app may itself be a launcher. For example, to run the open source [Fossify
30+
Launcher]:
31+
32+
```bash
33+
scrcpy --new-display=1920x1080 --no-vd-system-decorations --start-app=org.fossify.home
34+
```
35+
36+
[Fossify Launcher]: https://f-droid.org/en/packages/org.fossify.home/
37+
38+
2739
## System decorations
2840

29-
By default, virtual display system decorations are enabled. But some devices
30-
might display a broken UI;
41+
By default, virtual display system decorations are enabled. To disable them, use
42+
`--no-vd-system-decorations`:
43+
44+
```
45+
scrcpy --new-display --no-vd-system-decorations
46+
```
3147

32-
Use `--no-vd-system-decorations` to disable it.
48+
This is useful for some devices which might display a broken UI, or to disable
49+
any default launcher UI available in virtual displays.
3350

3451
Note that if no app is started, no content will be rendered, so no video frame
3552
will be produced at all.

0 commit comments

Comments
 (0)