It runs a server on your computer (host) that streams your Android screen to a webpage. You can open that webpage on Chrome, Firefox, or Edge on any device on the same network—or even across the globe—and interact with the phone via mouse clicks, keyboard inputs, and touch events.
Understanding the architecture demystifies the setup process.
: It can connect to devices via USB or over TCP/IP (ADB over Wi-Fi). Core Use Cases
Scrcpy 是 Genymobile 开发的一款命令行工具，能够在桌面端实时显示和控制 Android 设备，以其低延迟和高画质著称。而 ws-scrcpy 在继承 scrcpy 核心能力的基础上，将控制界面搬到了网页中，实现了真正的跨平台访问。两者的核心区别在于：原生 scrcpy 需要在本地安装客户端程序，而 ws-scrcpy 通过浏览器呈现，用户可以随时随地通过网页访问。 ws-scrcpy
ws-scrcpy brings a much-needed level of accessibility to the already impressive scrcpy ecosystem. By removing the need for a native client, it makes Android screen mirroring and control a truly web-centric experience, offering a, flexible, and powerful solution for developers and everyday users alike.
# Clone the Docker wrapper repository git clone https://github.com/deckyfx/ws-scrcpy-docker.git cd ws-scrcpy-docker
WS-SCRCPY is highly configurable using command-line arguments. Here are the most powerful flags. It runs a server on your computer (host)
*scrcpy can be scripted for multiple devices but requires separate windows.
Ensure adb is available in your PATH. If you need to specify a custom ADB path, create build/config/override.json :
(Replace 0bb4 with your device's Vendor ID found via lsusb . Reload rules with udevadm control --reload-rules && udevadm trigger ) . : It can connect to devices via USB
The open-source landscape of Android device management changed when Genymobile introduced (Screen Copy), allowing users to mirror and control their Android screens via a simple USB or TCP/IP connection. However, scrcpy required installing a native desktop client. Enter ws-scrcpy , a web-client prototype that brings native-level Android control directly to modern web browsers.
⚠️ : WS-Scrcpy does not include encryption or authentication by default. Never expose it directly to the internet without proper security measures.
项目提供了示例配置文件 config.example.yaml ，可通过复制创建自定义配置：