Display and control your Android device
Update documentation for --no-window
Romain Vimontb5c8de08e043
diff --git a/doc/audio.md b/doc/audio.mdindex ecae4468..30dd0f97 100644--- a/doc/audio.md+++ b/doc/audio.md@@ -28,10 +28,17 @@ To disable only the audio playback, see [no playback](video.md#no-playback).## Audio only-To play audio only, disable the video:+To play audio only, disable video and control:```bash-scrcpy --no-video+scrcpy --no-video --no-control+```++To play audio without a window:++```bash+# --no-video and --no-control are implied by --no-window+scrcpy --no-window# interrupt with Ctrl+C```diff --git a/doc/control.md b/doc/control.mdindex e9fd9e9b..87897894 100644--- a/doc/control.md+++ b/doc/control.md@@ -15,6 +15,31 @@ scrcpy -n # short versionRead [keyboard](keyboard.md) and [mouse](mouse.md).+## Control only++To control the device without mirroring:++```bash+scrcpy --no-video --no-audio+```++By default, mouse mode is switched to UHID if video mirroring is disabled (a+relative mouse mode is required).++To also use a UHID keyboard, set it explicitly:++```bash+scrcpy --no-video --no-audio --keyboard=uhid+scrcpy --no-video --no-audio -K # short version+```++To use AOA instead (over USB only):++```bash+scrcpy --no-video --no-audio --keyboard=aoa --mouse=aoa+```++## Copy-pasteAny time the Android clipboard changes, it is automatically synchronized to thediff --git a/doc/otg.md b/doc/otg.mdindex 3c7ed467..5f42ac9c 100644--- a/doc/otg.md+++ b/doc/otg.md@@ -1,19 +1,21 @@# OTGBy default, _scrcpy_ injects input events at the Android API level. As an-alternative, when connected over USB, it is possible to send HID events, so that-scrcpy behaves as if it was a physical keyboard and/or mouse connected to the-Android device.+alternative, it is possible to send HID events, so that scrcpy behaves as if it+was a [physical keyboard] and/or a [physical mouse] connected to the Android+device (see [keyboard](keyboard.md) and [mouse](mouse.md)).-A special mode allows to control the device without mirroring, using AOA-[keyboard](keyboard.md#aoa) and [mouse](mouse.md#aoa). Therefore, it is possible-to run _scrcpy_ with only physical keyboard and mouse simulation (HID), as if-the computer keyboard and mouse were plugged directly to the device via an OTG-cable.+[physical keyboard]: keyboard.md#physical-keyboard-simulation+[physical mouse]: physical-keyboard-simulation-In this mode, `adb` (USB debugging) is not necessary, and mirroring is disabled.+A special mode (OTG) allows to control the device using AOA+[keyboard](keyboard.md#aoa) and [mouse](mouse.md#aoa), without using _adb_ at+all (so USB debugging is not necessary). In this mode, video and audio are+disabled, and `--keyboard=aoa and `--mouse=aoa` are implicitly set.-This is similar to `--keyboard=aoa --mouse=aoa`, but without mirroring.+Therefore, it is possible to run _scrcpy_ with only physical keyboard and mouse+simulation, as if the computer keyboard and mouse were plugged directly to the+device via an OTG cable.To enable OTG mode:@@ -23,7 +25,7 @@ scrcpy --otgscrcpy --otg -s 0123456789abcdef```-It is possible to disable HID keyboard or HID mouse:+It is possible to disable keyboard or mouse:```bashscrcpy --otg --keyboard=disabled@@ -35,3 +37,22 @@ It only works if the device is connected over USB.## OTG issues on WindowsSee [FAQ](/FAQ.md#otg-issues-on-windows).+++## Control only++Note that the purpose of OTG is to control the device without USB debugging+(adb).++If you want to solely control the device without mirroring while USB debugging+is enabled, then OTG mode is not necessary.++Instead, disable video and audio, and select UHID (or AOA):++```bash+scrcpy --no-video --no-audio --keyboard=uhid --mouse=uhid+scrcpy --no-video --no-audio -KM # short version+scrcpy --no-video --no-audio --keyboard=aoa --mouse=aoa+```++One benefit of UHID is that it also works wirelessly.diff --git a/doc/recording.md b/doc/recording.mdindex 216542e9..f1a5a6e7 100644--- a/doc/recording.md+++ b/doc/recording.md@@ -58,12 +58,10 @@ orientation](video.md#orientation).## No playback-To disable playback while recording:+To disable playback and control while recording:```bash-scrcpy --no-playback --record=file.mp4-scrcpy -Nr file.mkv-# interrupt recording with Ctrl+C+scrcpy --no-playback --no-control --record=file.mp4```It is also possible to disable video and audio playback separately:@@ -73,6 +71,13 @@ It is also possible to disable video and audio playback separately:scrcpy --record=file.mkv --no-audio-playback```+To also disable the window:++```bash+scrcpy --no-playback --no-window --record=file.mp4+# interrupt recording with Ctrl+C+```+## Time limitTo limit the recording time:diff --git a/doc/window.md b/doc/window.mdindex b5b73921..b72c716c 100644--- a/doc/window.md+++ b/doc/window.md@@ -1,5 +1,14 @@# Window+## Disable window++To disable window (may be useful for recording or for playing audio only):++```bash+scrcpy --no-window --record=file.mp4+# Ctrl+C to interrupt+```+## TitleBy default, the window title is the device model. It can be changed: