doc/shortcuts.md
Actions can be performed on the scrcpy window using keyboard and mouse shortcuts.
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:
# use RCtrl for shortcuts
scrcpy --shortcut-mod=rctrl
# use either LCtrl or LSuper for shortcuts
scrcpy --shortcut-mod=lctrl,lsuper
<kbd>Super</kbd> is typically the <kbd>Windows</kbd> or <kbd>Cmd</kbd> key.
| Action | Shortcut |
|---|---|
| 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) |
| Flip display horizontally | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>←</kbd> (left) | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>→</kbd> (right) |
| Flip display vertically | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>↑</kbd> (up) | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>↓</kbd> (down) |
| Pause or re-pause display | <kbd>MOD</kbd>+<kbd>z</kbd> |
| Unpause display | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>z</kbd> |
| Reset video capture/encoding | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>r</kbd> |
| 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-left-click¹ |
Click on HOME | <kbd>MOD</kbd>+<kbd>h</kbd> | Middle-click |
Click on BACK | <kbd>MOD</kbd>+<kbd>b</kbd> | <kbd>MOD</kbd>+<kbd>Backspace</kbd> | Right-click² |
Click on APP_SWITCH | <kbd>MOD</kbd>+<kbd>s</kbd> | 4th-click³ |
Click on MENU (unlock screen)⁴ | <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) | <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> | 5th-click³ |
| Expand settings panel | <kbd>MOD</kbd>+<kbd>n</kbd>+<kbd>n</kbd> | Double-5th-click³ |
| Collapse panels | <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> |
| Open keyboard settings (HID keyboard only) | <kbd>MOD</kbd>+<kbd>k</kbd> |
| Enable/disable FPS counter (on stdout) | <kbd>MOD</kbd>+<kbd>i</kbd> |
| Pinch-to-zoom/rotate | <kbd>Ctrl</kbd>+click-and-move |
| Tilt vertically (slide with 2 fingers) | <kbd>Shift</kbd>+click-and-move |
| Tilt horizontally (slide with 2 fingers) | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click-and-move |
| Drag & drop APK file | Install APK from computer |
| Drag & drop non-APK file | Push file to device |
¹Double-click on black borders to remove them.
²Right-click turns the screen on if it was off, presses BACK otherwise.
³4th and 5th mouse buttons, if your mouse has them.
⁴For react-native apps in development, MENU triggers development menu.
⁵Only on Android >= 7.
Shortcuts with repeated keys are executed by releasing and pressing the key a second time. For example, to execute "Expand settings panel":
All <kbd>Ctrl</kbd>+key shortcuts are forwarded to the device, so they are handled by the active application.