v2.6
Genymobile/scrcpyv2.6Aug 1, 2024by rom1v
AI Summary
Introduces audio playback capture and duplication features, allowing audio to be mirrored or played on the device while being captured. It also adds secondary mouse bindings.
Key Highlights
- Audio playback capture method and duplication feature.
- Secondary mouse bindings via Shift+click (default shortcuts, Shift for device clicks).
- Fixes --turn-screen-off for Honor devices.
- Adapts audio workarounds for Android 14.
New Features
- Audio playback capture source.
- Audio duplication.
- Secondary mouse bindings.
Full Release Notes
_To receive a notification on new releases, click on **Watch > Custom > Releases** on the top._ --- **scrcpy v2.6** Changes since v2.5: - Add audio playback capture method (#4380, #5102) - Add audio duplication feature (#3875, #4380, #5102) - Add mouse secondary bindings with Shift+click (#5055, #5076) - Rework mouse events (#5067, #5076) - Fix "turn screen off" for Honor devices (#4823, #4943, #5109) - Add clipboard workaround for Honor devices (#4822, #5073) - Always apply device workarounds (#4922, #5140, #5148, #5154) - Fix missing initialization (#5057, #5058) - Do not report error on device disconnected (#5044) - Upgrade SDL to 2.30.5 in Windows releases - Various technical fixes --- # Highlights ## Audio mirroring Audio forwarding was introduced in scrcpy 2.0. Until now, when audio was captured by scrcpy, it was necessarily disabled on the device. This release introduces a new audio capture method, which (optionally) supports audio duplication, to keep playing audio on the device. It is exposed as an alternative audio source named `playback` (in addition to `output`, the default, and `mic`). ```bash scrcpy --audio-source=playback # do not play on the device scrcpy --audio-source=playback --audio-dup # keep playing on the device ``` For convenience, `--audio-dup` automatically selects the `playback` audio source. Therefore, to **mirror** audio rather than **forward**, this is sufficient: ```bash scrcpy --audio-dup ``` However, this playback capture has some drawbacks: - it requires Android 13 (rather than Android 11), - Android apps can opt-out, in which case they are not captured. See [documentation](https://github.com/Genymobile/scrcpy/blob/master/doc/audio.md#duplication), #4380, #5102. ## Secondary mouse bindings By default, with SDK mouse: - right-click triggers BACK (or POWER on) - middle-click triggers HOME - the 4th click triggers APP_SWITCH - the 5th click expands the notification panel It was also possible to forward the clicks to the device instead, by using the `--mouse-bind=xxxx` option introduced in the previous version (2.5). But that way, we had to choose at startup whether a button triggered a shortcut or a click. This release introduces a new set of secondary bindings via <kbd>Shift</kbd>+click, so that both are possible at runtime. **By default, a simple (secondary) click triggers the shortcuts, and <kbd>Shift</kbd>+click forwards the click to the device.** _In AOA and UHID mouse modes, the default bindings are reversed: all clicks are forwarded by default, and pressing <kbd>Shift</kbd> gives access to the shortcuts (since the cursor is handled on the device side, it makes more sense to forward all mouse buttons by default in these modes)._ All these mouse bindings can be configured, check the [documentation](https://github.com/Genymobile/scrcpy/blob/master/doc/mouse.md#mouse-bindings). See [#5076](https://github.com/Genymobile/scrcpy/pull/5076). --- - Twitter: [`@scrcpy_app`](https://twitter.com/scrcpy_app) - Reddit: [`r/scrcpy`](https://www.reddit.com/r/scrcpy)