6c6607d404
Add an option to disable the following flag for virtual displays:
DisplayManager.VIRTUAL_DISPLAY_FLAG_DESTROY_CONTENT_ON_REMOVAL
With this option, when the virtual display is closed, the running apps
are moved to the main display rather than being destroyed.
PR #5615 <https://github.com/Genymobile/scrcpy/pull/5615>
64 lines
1.6 KiB
Markdown
64 lines
1.6 KiB
Markdown
# Virtual display
|
|
|
|
## New display
|
|
|
|
To mirror a new virtual display instead of the device screen:
|
|
|
|
```bash
|
|
scrcpy --new-display=1920x1080
|
|
scrcpy --new-display=1920x1080/420 # force 420 dpi
|
|
scrcpy --new-display # use the main display size and density
|
|
scrcpy --new-display=/240 # use the main display size and 240 dpi
|
|
```
|
|
|
|
## Start app
|
|
|
|
On some devices, a launcher is available in the virtual display.
|
|
|
|
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:
|
|
|
|
```bash
|
|
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. To disable them, use
|
|
`--no-vd-system-decorations`:
|
|
|
|
```
|
|
scrcpy --new-display --no-vd-system-decorations
|
|
```
|
|
|
|
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 frame
|
|
will be produced at all.
|
|
|
|
|
|
## Destroy on close
|
|
|
|
By default, when the virtual display is closed, the running apps are destroyed.
|
|
|
|
To move them to the main display instead, use:
|
|
|
|
```
|
|
scrcpy --new-display --no-vd-destroy-content
|
|
```
|