Use <kbd> HTML tag for keys
It's prettyier in a browser.
This commit is contained in:
parent
dfb7324d7b
commit
d49cffb938
1 changed files with 61 additions and 56 deletions
117
README.md
117
README.md
|
@ -354,7 +354,7 @@ scrcpy --fullscreen
|
|||
scrcpy -f # short version
|
||||
```
|
||||
|
||||
Fullscreen can then be toggled dynamically with `MOD`+`f`.
|
||||
Fullscreen can then be toggled dynamically with <kbd>MOD</kbd>+<kbd>f</kbd>.
|
||||
|
||||
#### Rotation
|
||||
|
||||
|
@ -370,18 +370,19 @@ Possibles values are:
|
|||
- `2`: 180 degrees
|
||||
- `3`: 90 degrees clockwise
|
||||
|
||||
The rotation can also be changed dynamically with `MOD`+`←` _(left)_ and
|
||||
`MOD`+`→` _(right)_.
|
||||
The rotation can also be changed dynamically with <kbd>MOD</kbd>+<kbd>←</kbd>
|
||||
_(left)_ and <kbd>MOD</kbd>+<kbd>→</kbd> _(right)_.
|
||||
|
||||
Note that _scrcpy_ manages 3 different rotations:
|
||||
- `MOD`+`r` requests the device to switch between portrait and landscape (the
|
||||
current running app may refuse, if it does support the requested
|
||||
orientation).
|
||||
- <kbd>MOD</kbd>+<kbd>r</kbd> requests the device to switch between portrait and
|
||||
landscape (the current running app may refuse, if it does support the
|
||||
requested orientation).
|
||||
- `--lock-video-orientation` changes the mirroring orientation (the orientation
|
||||
of the video sent from the device to the computer). This affects the
|
||||
recording.
|
||||
- `--rotation` (or `MOD`+`←`/`MOD`+`→`) rotates only the window content. This
|
||||
affects only the display, not the recording.
|
||||
- `--rotation` (or <kbd>MOD</kbd>+<kbd>←</kbd>/<kbd>MOD</kbd>+<kbd>→</kbd>)
|
||||
rotates only the window content. This affects only the display, not the
|
||||
recording.
|
||||
|
||||
|
||||
### Other mirroring options
|
||||
|
@ -437,9 +438,10 @@ scrcpy --turn-screen-off
|
|||
scrcpy -S
|
||||
```
|
||||
|
||||
Or by pressing `MOD`+`o` at any time.
|
||||
Or by pressing <kbd>MOD</kbd>+<kbd>o</kbd> at any time.
|
||||
|
||||
To turn it back on, press `MOD`+`Shift`+`o` (or `POWER`, `MOD`+`p`).
|
||||
To turn it back on, press <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>o</kbd> (or
|
||||
`POWER`, <kbd>MOD</kbd>+<kbd>p</kbd>).
|
||||
|
||||
It can be useful to also prevent the device to sleep:
|
||||
|
||||
|
@ -494,7 +496,8 @@ scrcpy --disable-screensaver
|
|||
|
||||
#### Rotate device screen
|
||||
|
||||
Press `MOD`+`r` to switch between portrait and landscape modes.
|
||||
Press <kbd>MOD</kbd>+<kbd>r</kbd> to switch between portrait and landscape
|
||||
modes.
|
||||
|
||||
Note that it rotates only if the application in foreground supports the
|
||||
requested orientation.
|
||||
|
@ -504,32 +507,34 @@ requested orientation.
|
|||
Any time the Android clipboard changes, it is automatically synchronized to the
|
||||
computer clipboard.
|
||||
|
||||
Any `Ctrl` shortcut is forwarded to the device. In particular:
|
||||
- `Ctrl`+`c` typically copies
|
||||
- `Ctrl`+`x` typically cuts
|
||||
- `Ctrl`+`v` typically pastes (after computer-to-device clipboard
|
||||
synchronization)
|
||||
Any <kbd>Ctrl</kbd> shortcut is forwarded to the device. In particular:
|
||||
- <kbd>Ctrl</kbd>+<kbd>c</kbd> typically copies
|
||||
- <kbd>Ctrl</kbd>+<kbd>x</kbd> typically cuts
|
||||
- <kbd>Ctrl</kbd>+<kbd>v</kbd> typically pastes (after computer-to-device
|
||||
clipboard synchronization)
|
||||
|
||||
This typically works as you expect.
|
||||
|
||||
The actual behavior depends on the active application though. For example,
|
||||
_Termux_ sends SIGINT on `Ctrl`+`c` instead, and _K-9 Mail_ composes a new
|
||||
message.
|
||||
_Termux_ sends SIGINT on <kbd>Ctrl</kbd>+<kbd>c</kbd> instead, and _K-9 Mail_
|
||||
composes a new message.
|
||||
|
||||
To copy, cut and paste in such cases (but only supported on Android >= 7):
|
||||
- `MOD`+`c` injects `COPY`
|
||||
- `MOD`+`x` injects `CUT`
|
||||
- `MOD`+`v` injects `PASTE` (after computer-to-device clipboard
|
||||
synchronization)
|
||||
- <kbd>MOD</kbd>+<kbd>c</kbd> injects `COPY`
|
||||
- <kbd>MOD</kbd>+<kbd>x</kbd> injects `CUT`
|
||||
- <kbd>MOD</kbd>+<kbd>v</kbd> injects `PASTE` (after computer-to-device
|
||||
clipboard synchronization)
|
||||
|
||||
In addition, `MOD`+`Shift`+`v` allows to inject the computer clipboard text as a
|
||||
sequence of key events. This is useful when the component does not accept text
|
||||
pasting (for example in _Termux_), but it can break non-ASCII content.
|
||||
In addition, <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>v</kbd> allows to inject the
|
||||
computer clipboard text as a sequence of key events. This is useful when the
|
||||
component does not accept text pasting (for example in _Termux_), but it can
|
||||
break non-ASCII content.
|
||||
|
||||
**WARNING:** Pasting the computer clipboard to the device (either via `Ctrl`+`v`
|
||||
or `MOD`+`v`) copies the content into the device clipboard. As a consequence,
|
||||
any Android application could read its content. You should avoid to paste
|
||||
sensitive content (like passwords) that way.
|
||||
**WARNING:** Pasting the computer clipboard to the device (either via
|
||||
<kbd>Ctrl</kbd>+<kbd>v</kbd> or <kbd>MOD</kbd>+<kbd>v</kbd>) copies the content
|
||||
into the device clipboard. As a consequence, any Android application could read
|
||||
its content. You should avoid to paste sensitive content (like passwords) that
|
||||
way.
|
||||
|
||||
#### Text injection preference
|
||||
|
||||
|
@ -589,8 +594,8 @@ Also see [issue #14].
|
|||
|
||||
## Shortcuts
|
||||
|
||||
In the following list, `MOD` is the shortcut modifier. By default, it's (left)
|
||||
`Alt` or (left) `Super`.
|
||||
In the following list, <kbd>MOD</kbd> is the shortcut modifier. By default, it's
|
||||
(left) <kbd>Alt</kbd> or (left) <kbd>Super</kbd>.
|
||||
|
||||
It can be changed using `--shortcut-mod`. Possible keys are `lctrl`, `rctrl`,
|
||||
`lalt`, `ralt`, `lsuper` and `rsuper`. For example:
|
||||
|
@ -603,42 +608,42 @@ scrcpy --shortcut-mod=rctrl
|
|||
scrcpy --shortcut-mod=lctrl+lalt,lsuper
|
||||
```
|
||||
|
||||
_[Super] is typically the "Windows" or "Cmd" key._
|
||||
_<kbd>[Super]</kbd> is typically the <kbd>Windows</kbd> or <kbd>Cmd</kbd> key._
|
||||
|
||||
[Super]: https://en.wikipedia.org/wiki/Super_key_(keyboard_button)
|
||||
|
||||
| Action | Shortcut
|
||||
| ------------------------------------------- |:-----------------------------
|
||||
| Switch fullscreen mode | `MOD`+`f`
|
||||
| Rotate display left | `MOD`+`←` _(left)_
|
||||
| Rotate display right | `MOD`+`→` _(right)_
|
||||
| Resize window to 1:1 (pixel-perfect) | `MOD`+`g`
|
||||
| Resize window to remove black borders | `MOD`+`w` \| _Double-click¹_
|
||||
| Click on `HOME` | `MOD`+`h` \| _Middle-click_
|
||||
| Click on `BACK` | `MOD`+`b` \| _Right-click²_
|
||||
| Click on `APP_SWITCH` | `MOD`+`s`
|
||||
| Click on `MENU` | `MOD`+`m`
|
||||
| Click on `VOLUME_UP` | `MOD`+`↑` _(up)_
|
||||
| Click on `VOLUME_DOWN` | `MOD`+`↓` _(down)_
|
||||
| Click on `POWER` | `MOD`+`p`
|
||||
| Switch fullscreen mode | <kbd>MOD</kbd>+<kbd>f</kbd>
|
||||
| Rotate display left | <kbd>MOD</kbd>+<kbd>←</kbd> _(left)_
|
||||
| Rotate display right | <kbd>MOD</kbd>+<kbd>→</kbd> _(right)_
|
||||
| Resize window to 1:1 (pixel-perfect) | <kbd>MOD</kbd>+<kbd>g</kbd>
|
||||
| Resize window to remove black borders | <kbd>MOD</kbd>+<kbd>w</kbd> \| _Double-click¹_
|
||||
| Click on `HOME` | <kbd>MOD</kbd>+<kbd>h</kbd> \| _Middle-click_
|
||||
| Click on `BACK` | <kbd>MOD</kbd>+<kbd>b</kbd> \| _Right-click²_
|
||||
| Click on `APP_SWITCH` | <kbd>MOD</kbd>+<kbd>s</kbd>
|
||||
| Click on `MENU` | <kbd>MOD</kbd>+<kbd>m</kbd>
|
||||
| Click on `VOLUME_UP` | <kbd>MOD</kbd>+<kbd>↑</kbd> _(up)_
|
||||
| Click on `VOLUME_DOWN` | <kbd>MOD</kbd>+<kbd>↓</kbd> _(down)_
|
||||
| Click on `POWER` | <kbd>MOD</kbd>+<kbd>p</kbd>
|
||||
| Power on | _Right-click²_
|
||||
| Turn device screen off (keep mirroring) | `MOD`+`o`
|
||||
| Turn device screen on | `MOD`+`Shift`+`o`
|
||||
| Rotate device screen | `MOD`+`r`
|
||||
| Expand notification panel | `MOD`+`n`
|
||||
| Collapse notification panel | `MOD`+`Shift`+`n`
|
||||
| Copy to clipboard³ | `MOD`+`c`
|
||||
| Cut to clipboard³ | `MOD`+`x`
|
||||
| Synchronize clipboards and paste³ | `MOD`+`v`
|
||||
| Inject computer clipboard text | `MOD`+`Shift`+`v`
|
||||
| Enable/disable FPS counter (on stdout) | `MOD`+`i`
|
||||
| Turn device screen off (keep mirroring) | <kbd>MOD</kbd>+<kbd>o</kbd>
|
||||
| Turn device screen on | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>o</kbd>
|
||||
| Rotate device screen | <kbd>MOD</kbd>+<kbd>r</kbd>
|
||||
| Expand notification panel | <kbd>MOD</kbd>+<kbd>n</kbd>
|
||||
| Collapse notification panel | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>n</kbd>
|
||||
| Copy to clipboard³ | <kbd>MOD</kbd>+<kbd>c</kbd>
|
||||
| Cut to clipboard³ | <kbd>MOD</kbd>+<kbd>x</kbd>
|
||||
| Synchronize clipboards and paste³ | <kbd>MOD</kbd>+<kbd>v</kbd>
|
||||
| Inject computer clipboard text | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>v</kbd>
|
||||
| Enable/disable FPS counter (on stdout) | <kbd>MOD</kbd>+<kbd>i</kbd>
|
||||
|
||||
_¹Double-click on black borders to remove them._
|
||||
_²Right-click turns the screen on if it was off, presses BACK otherwise._
|
||||
_³Only on Android >= 7._
|
||||
|
||||
All `Ctrl`+_key_ shortcuts are forwarded to the device, so they are handled by
|
||||
the active application.
|
||||
All <kbd>Ctrl</kbd>+_key_ shortcuts are forwarded to the device, so they are
|
||||
handled by the active application.
|
||||
|
||||
|
||||
## Custom paths
|
||||
|
|
Loading…
Reference in a new issue