2023-03-12 09:37:49 +08:00
|
|
|
|
# scrcpy (v2.0)
|
2017-12-12 22:54:33 +08:00
|
|
|
|
|
2022-02-23 08:21:18 +08:00
|
|
|
|
<img src="app/data/icon.svg" width="128" height="128" alt="scrcpy" align="right" />
|
2021-10-23 15:29:30 +08:00
|
|
|
|
|
2022-01-28 00:08:14 +08:00
|
|
|
|
_pronounced "**scr**een **c**o**py**"_
|
|
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
This application mirrors Android devices (video and audio) connected via
|
|
|
|
|
|
USB or [over TCP/IP](doc/device.md#tcpip-wireless), and allows to control the
|
|
|
|
|
|
device with the keyboard and the mouse of the computer. It does not require any
|
|
|
|
|
|
_root_ access. It works on _Linux_, _Windows_ and _macOS_.
|
2017-12-12 22:54:33 +08:00
|
|
|
|
|
2018-02-14 02:31:44 +08:00
|
|
|
|
|
2017-12-12 22:54:33 +08:00
|
|
|
|
|
2019-08-04 20:43:08 +08:00
|
|
|
|
It focuses on:
|
|
|
|
|
|
|
2021-11-13 16:39:26 +08:00
|
|
|
|
- **lightness**: native, displays only the device screen
|
|
|
|
|
|
- **performance**: 30~120fps, depending on the device
|
|
|
|
|
|
- **quality**: 1920×1080 or above
|
|
|
|
|
|
- **low latency**: [35~70ms][lowlatency]
|
|
|
|
|
|
- **low startup time**: ~1 second to display the first image
|
2022-04-10 23:45:34 +08:00
|
|
|
|
- **non-intrusiveness**: nothing is left installed on the Android device
|
2021-11-13 16:39:26 +08:00
|
|
|
|
- **user benefits**: no account, no ads, no internet required
|
|
|
|
|
|
- **freedom**: free and open source software
|
2019-08-04 20:43:08 +08:00
|
|
|
|
|
|
|
|
|
|
[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646
|
|
|
|
|
|
|
2021-11-13 16:39:26 +08:00
|
|
|
|
Its features include:
|
2023-03-04 15:56:35 +08:00
|
|
|
|
- [audio forwarding](doc/audio.md) (Android >= 11)
|
|
|
|
|
|
- [recording](doc/recording.md)
|
|
|
|
|
|
- mirroring with [Android device screen off](doc/device.md#turn-screen-off)
|
|
|
|
|
|
- [copy-paste](doc/control.md#copy-paste) in both directions
|
|
|
|
|
|
- [configurable quality](doc/video.md)
|
2023-03-15 17:36:07 +08:00
|
|
|
|
- Android device screen [as a webcam (V4L2)](doc/v4l2.md) (Linux-only)
|
2023-03-04 15:56:35 +08:00
|
|
|
|
- [physical keyboard/mouse simulation (HID)](doc/hid-otg.md)
|
|
|
|
|
|
- [OTG mode](doc/hid-otg.md#otg)
|
2021-11-13 16:39:26 +08:00
|
|
|
|
- and more…
|
2017-12-12 22:54:33 +08:00
|
|
|
|
|
2023-03-13 15:40:31 +08:00
|
|
|
|
## Prerequisites
|
2018-02-14 02:31:44 +08:00
|
|
|
|
|
2019-07-21 16:08:27 +08:00
|
|
|
|
The Android device requires at least API 21 (Android 5.0).
|
2018-02-14 02:31:44 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
[Audio forwarding](doc/audio.md) is supported from API 30 (Android 11).
|
|
|
|
|
|
|
2023-03-13 17:17:08 +08:00
|
|
|
|
Make sure you [enabled USB debugging][enable-adb] on your device(s).
|
2018-02-14 02:31:44 +08:00
|
|
|
|
|
2023-03-13 17:17:08 +08:00
|
|
|
|
[enable-adb]: https://developer.android.com/studio/debug/dev-options#enable
|
2018-02-14 02:31:44 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
On some devices, you also need to enable [an additional option][control] `USB
|
|
|
|
|
|
debugging (Security Settings)` (this is an item different from `USB debugging`)
|
|
|
|
|
|
to control it using a keyboard and mouse.
|
2018-11-25 18:29:27 +08:00
|
|
|
|
|
|
|
|
|
|
[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
|
|
|
|
|
|
|
2018-02-14 02:31:44 +08:00
|
|
|
|
|
2018-08-17 23:49:13 +08:00
|
|
|
|
## Get the app
|
2017-12-12 22:54:33 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
- [Linux](doc/linux.md)
|
|
|
|
|
|
- [Windows](doc/windows.md)
|
|
|
|
|
|
- [macOS](doc/macos.md)
|
2018-09-05 00:40:57 +08:00
|
|
|
|
|
2018-11-12 00:27:59 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
## User documentation
|
2018-11-12 00:27:59 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
The application provides a lot of features and configuration options. They are
|
|
|
|
|
|
documented in the following pages:
|
2018-11-14 03:36:57 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
- [Device](doc/device.md)
|
|
|
|
|
|
- [Video](doc/video.md)
|
|
|
|
|
|
- [Audio](doc/audio.md)
|
|
|
|
|
|
- [Control](doc/control.md)
|
|
|
|
|
|
- [Window](doc/window.md)
|
|
|
|
|
|
- [Recording](doc/recording.md)
|
|
|
|
|
|
- [Tunnels](doc/tunnels.md)
|
|
|
|
|
|
- [HID/OTG](doc/hid-otg.md)
|
|
|
|
|
|
- [Video4Linux](doc/v4l2.md)
|
|
|
|
|
|
- [Shortcuts](doc/shortcuts.md)
|
2018-11-14 03:36:57 +08:00
|
|
|
|
|
|
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
## Resources
|
2018-11-14 03:36:57 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
- [FAQ](FAQ.md)
|
|
|
|
|
|
- [Translations][wiki] (not necessarily up to date)
|
|
|
|
|
|
- [Build instructions](doc/build.md)
|
|
|
|
|
|
- [Developers](doc/develop.md)
|
2018-11-14 03:36:57 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
[wiki]: https://github.com/Genymobile/scrcpy/wiki
|
2018-03-08 16:25:02 +08:00
|
|
|
|
|
|
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
## Articles
|
2018-03-08 16:25:02 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
- [Introducing scrcpy][article-intro]
|
|
|
|
|
|
- [Scrcpy now works wirelessly][article-tcpip]
|
2023-03-13 04:08:30 +08:00
|
|
|
|
- [Scrcpy 2.0, with audio][article-scrcpy2]
|
2018-03-08 16:25:02 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
|
|
|
|
|
|
[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
|
2023-03-13 04:08:30 +08:00
|
|
|
|
[article-scrcpy2]: https://blog.rom1v.com/2023/03/scrcpy-2-0-with-audio/
|
2018-08-17 23:49:13 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
## Contact
|
2018-08-17 23:49:13 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
If you encounter a bug, please read the [FAQ](FAQ.md) first, then open an [issue].
|
2018-08-17 23:49:13 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
[issue]: https://github.com/Genymobile/scrcpy/issues
|
2018-03-11 17:34:11 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
For general questions or discussions, you can also use:
|
2022-02-23 02:31:35 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
- Reddit: [`r/scrcpy`](https://www.reddit.com/r/scrcpy)
|
|
|
|
|
|
- Twitter: [`@scrcpy_app`](https://twitter.com/scrcpy_app)
|
2018-03-11 17:34:11 +08:00
|
|
|
|
|
|
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
## Donate
|
2018-03-08 16:25:02 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
I'm [@rom1v](https://github.com/rom1v), the author and maintainer of _scrcpy_.
|
2018-03-08 16:25:02 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
If you appreciate this application, you can [support my open source
|
|
|
|
|
|
work][donate].
|
2018-03-08 16:25:02 +08:00
|
|
|
|
|
2023-03-04 15:56:35 +08:00
|
|
|
|
[donate]: https://blog.rom1v.com/about/#support-my-open-source-work
|
2018-03-08 16:25:02 +08:00
|
|
|
|
|
2018-02-14 02:31:44 +08:00
|
|
|
|
## Licence
|
2017-12-12 22:54:33 +08:00
|
|
|
|
|
2018-02-14 02:31:44 +08:00
|
|
|
|
Copyright (C) 2018 Genymobile
|
2023-03-04 16:08:42 +08:00
|
|
|
|
Copyright (C) 2018-2023 Romain Vimont
|
2017-12-12 22:54:33 +08:00
|
|
|
|
|
2018-02-14 02:31:44 +08:00
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
|
|
you may not use this file except in compliance with the License.
|
|
|
|
|
|
You may obtain a copy of the License at
|
2017-12-12 22:54:33 +08:00
|
|
|
|
|
2018-02-14 02:31:44 +08:00
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
2018-02-04 19:17:34 +08:00
|
|
|
|
|
2018-02-14 02:31:44 +08:00
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
|
|
See the License for the specific language governing permissions and
|
|
|
|
|
|
limitations under the License.
|
