WS-SCRCPY is an open-source web-based prototype designed to extend the capabilities of the popular scrcpy tool, allowing users to mirror and control Android devices directly through a web browser. While the original scrcpy by Genymobile is a high-performance desktop application, ws-scrcpy leverages WebSockets to provide a similar experience without requiring a native client on the viewing machine. Core Features of WS-SCRCPY
The primary appeal of ws-scrcpy is its accessibility and cross-platform flexibility.
Browser-Based Mirroring: Stream your Android screen as H.264 video directly to any modern browser.
Full Remote Control: Use your computer's mouse and keyboard to interact with the device. This includes multi-touch emulation (using CTRL or SHIFT keys) and scroll support.
Multi-Device Management: Connect and switch between multiple Android devices from a single web interface.
Advanced File Handling: Drag-and-drop support for pushing APKs or other files to the device's storage.
Remote Shell Access: Open an ADB shell directly in the browser using an integrated xterm.js terminal emulator.
Configurable Quality: Adjust video quality, bitrate, and resolution to optimize performance for different network conditions. How WS-SCRCPY Works
Unlike standard scrcpy, which uses a direct USB or TCP/IP connection to a desktop binary, ws-scrcpy acts as a bridge. It runs a Node.js server that communicates with a modified version of the scrcpy-server on the Android device. The server converts the device's video stream and input events into WebSockets, which the browser can then interpret in real-time. Installation and Setup
To get started with ws-scrcpy, you typically need to set up the server environment on a host computer (Windows, macOS, or Linux) that has the Android device connected via USB or accessible over the same Wi-Fi network. Prerequisites:
Ensure USB Debugging is enabled in your Android device's "Developer Options".
Install Node.js and ADB (Android Debug Bridge) on your host computer. Server Setup:
Download the latest release from the ws-scrcpy GitHub repository.
Install dependencies and build the project (often using npm install and npm run build or npm start).
Recent community updates have also introduced Docker support, making it easier to deploy in containerized environments like Unraid or home servers. Accessing the Device:
Once the server is running, open your browser and navigate to the local address (usually http://localhost:8000).
Select your connected device from the list to begin the mirroring session. Comparison: WS-SCRCPY vs. Standard SCRCPY
NetrisTV/ws-scrcpy: Web client prototype for scrcpy. - GitHub
ws-scrcpy is a web-based client for scrcpy, allowing you to mirror and control Android devices directly through a web browser using WebSockets. This is particularly useful for remote access without installing a native client on every computer. Key Features ws-scrcpy
Browser-Based Access: Control your Android device from any modern web browser.
Low Latency: Utilizes WebSockets for high-performance video and audio streaming.
Remote Management: Includes features like remote shell access and minimalistic file management.
No Root Required: Like the original scrcpy, it operates via ADB and does not need root permissions. Prerequisites Before setting up ws-scrcpy, ensure you have:
Genymobile/scrcpy: Display and control your Android device - GitHub
is a web-based client prototype for , allowing you to mirror and control Android devices directly through a web browser. It eliminates the need for standalone desktop applications by leveraging WebSockets for low-latency communication. Key Features Web-Based Control
: View and interact with your Android device using mouse clicks, key strokes, and touch events within a browser window. Multiple Decoders
: Supports several decoding options to suit different browser capabilities: Mse Player : Uses the Media Source API for H.264 video. Broadway Player
: A software-based decoder compiled into WebAssembly (Wasm) for browsers without hardware acceleration. WebCodecs Player : Modern, high-performance decoding for supported browsers. Persistent Connection : Unlike the original scrcpy, the
server can keep the server-side jar running on the device even after a disconnection, allowing for easier re-connection via IP. Developer Tools Integration
: Includes features like remote shell access (via xterm.js) and the ability to debug web pages or web views on the connected device. iOS Support (Limited)
: Offers a prototype for tracking and basic control of iOS devices, though functionality differs from the Android implementation. Architecture & Customization
The tool is built using TypeScript and Node.js. Users can customize their builds by modifying a configuration file (e.g., build.config.override.json ) to include or exclude specific features: INCLUDE_ADB_SHELL : Enables the remote shell feature. INCLUDE_FILE_LISTING : Adds a simple file management interface. SCRCPY_LISTENS_ON_ALL_INTERFACES
: If set to true, allows direct browser connections to the device without routing through a local ADB server. Common Use Cases
NetrisTV/ws-scrcpy: Web client prototype for scrcpy. - GitHub
is a web-based client prototype for , the popular open-source tool for mirroring and controlling Android devices from a computer. Unlike the standard version that runs as a desktop application,
allows you to view and control your phone directly through a web browser using WebSockets. Key Features Browser-Based Control
: Mirror your screen and use touch events, keyboard input, and mouse/touchpad scrolling without a dedicated desktop client. Multiple Players : Supports several video decoders including (for Chrome/Chromium), File Management WS-SCRCPY is an open-source web-based prototype designed to
: Supports dragging and dropping APKs for installation, file pushing, and browsing device files. Remote Shell : Access a remote shell directly from your browser. Device Interaction
: Supports device rotation, multi-touch emulation, and clipboard sharing between the device and computer. Prerequisites Android Device : Must be running Android 5.0 (API 21) or higher. USB Debugging : You must enable Developer Options and turn on USB Debugging on your Android device. Server Environment : Requires a server (often
) to handle the WebSocket communication between the browser and the device. Quick Setup Steps Prepare the Phone Settings > About Phone and tap the Build Number seven times to unlock Developer Options. Enable USB Debugging Install Node.js & ws-scrcpy : Download the ws-scrcpy repository and install dependencies using npm install Run the Server : Start the server using the provided commands (usually or building from source). Connect via Browser
: Open your browser and navigate to the local address (typically
The Evolution of Remote Access: A Look at ws-scrcpy (screen copy) has long been the gold standard for mirroring and controlling Android devices from a desktop, prized for its high performance and low latency. However, as cross-platform needs grew, developers sought ways to bypass the requirement of a local desktop client. Enter
, a specialized fork that brings the power of scrcpy into the web browser via WebSockets. Bridging the Gap to the Browser
Unlike the original scrcpy, which requires a standalone application on the host PC,
operates as a web client prototype. It utilizes a modified version of the scrcpy-server.jar
that integrates a WebSocket server, allowing the Android device to listen for connections on all network interfaces. Browser-Based Interaction
: Users can control their physical or virtual Android devices directly through a web browser, making it accessible on any OS without local software installation. Persistent Connections
: A key technical departure is that the ws-scrcpy server remains running on the device even after a client disconnects, facilitating easier reconnection. Diverse Playback Options
: To ensure compatibility, ws-scrcpy includes multiple video decoders, such as Mse Player for HTML5 video, (software-based), and for Chromium-based browsers. Advanced Functionality and Use Cases
ws-scrcpy is not just a mirroring tool; it provides a suite of remote management features that extend into professional and experimental realms: Full Remote Control
: It supports multi-touch emulation, keyboard event capturing, and bidirectional clipboard synchronization. Remote Shell and File Management : Integrated
allows for adb shell access directly in the browser, alongside minimalistic file management for uploading and downloading files via drag-and-drop. Experimental iOS Support
: While primarily for Android, recent iterations have included experimental support for iOS screen casting using WebDriverAgent. Docker and Cloud Integration
: The tool is highly suitable for remote Android applications running as Docker containers in the cloud, allowing developers to manage "headless" devices through a visual interface. Security and Maintenance Considerations
While powerful, ws-scrcpy is a "prototype" with significant security warnings. By default, there is no encryption Your device should appear in the ws-scrcpy web interface
or authorization between the browser and the device's WebSocket server. Users must manually configure HTTPS or other security layers for safe use in non-private networks.
ws-scrcpy is a specialized web-based extension of the renowned open-source tool scrcpy. Developed by NetEase, it transforms the core functionality of screen mirroring and remote control into a browser-accessible experience, eliminating the need for a dedicated local client. The Evolution of Screen Mirroring
Traditional mirroring tools, like the original scrcpy, rely on a direct desktop interface and a local installation. While highly efficient with ultra-low latency (35–70ms), they can be restrictive for teams or users who need to access devices remotely across different networks. ws-scrcpy bridges this gap by acting as a bridge between the Android Debug Bridge (ADB) and a web browser using WebSockets. Key Technical Advantages
Browser-Based Accessibility: Users can control their Android devices via any modern web browser (Chrome, Firefox, Safari) without installing separate software.
Remote Team Collaboration: It is particularly effective for quality assurance (QA) and development teams who need to share access to a single physical device located in a different office or data center.
Low Friction Setup: Like its predecessor, it requires no root access and no app installation on the Android device itself.
Feature Parity: It retains essential features such as keyboard/mouse control, file drag-and-drop, and high-quality video streaming. Use Cases and Impact
For Android developers, ws-scrcpy simplifies debugging by allowing them to view device logs and screens directly in the same browser where they might be managing other web-based development tools. For general users, it provides a seamless way to manage notifications or use mobile-only apps on a desktop environment without tethering themselves to a specific workstation.
In conclusion, ws-scrcpy represents the "cloudification" of device management. By leveraging the performance of scrcpy and the ubiquity of the web, it offers a powerful, flexible, and cross-platform solution for the modern, interconnected workflow. If you'd like to dive deeper into this topic:
Do you need a comparison between ws-scrcpy and other web-based tools like AirDroid?
Genymobile/scrcpy: Display and control your Android device - GitHub
Your device should appear in the ws-scrcpy web interface.
WS-SCRCPY is highly configurable using command-line arguments. Here are the most powerful flags.
If you only need access from your home network, bind ws-scrcpy to your LAN IP address only, or rely on your firewall to block external port 8000.
Docker is the easiest way to run ws-scrcpy because it bundles Node.js, dependencies, and often the ADB binaries into an isolated environment.
Access the UI:
Open your browser to http://localhost:8000.
| Tool | Platform | Multiple Devices | Web-Based | Latency | |------|----------|-----------------|-----------|---------| | ws-scrcpy | Web | ✅ Yes | ✅ Yes | Low (50-150ms) | | Original scrcpy | Desktop (Win/Mac/Linux) | ❌ One at a time | ❌ No | Very low (30-80ms) | | Vysor | Web/Desktop | ❌ (Paid feature) | ✅ Yes | Medium (100-200ms) | | TeamViewer Host | Mobile app | ❌ No | ✅ Yes | High (300-1000ms) | | AirDroid | Web/Desktop | ✅ Yes | ✅ Yes | High (200-500ms) |