Skip to main content
ohscrcpy

Windows tool

ohscrcpy

ohscrcpy is a Windows screen mirroring and remote control tool for OpenHarmony and Android devices.

GitHub Releases

Product Positioning

ohscrcpy is a Windows screen mirroring and remote control tool for OpenHarmony and Android devices. It focuses on real-device debugging, multi-device observation, and cross-platform device control in local networks.

It is not intended to replace a full mobile device management system. The goal is to provide a lightweight Windows entry point for connecting one or more devices, viewing their screens, and performing basic control.

Typical Scenarios

  • Debug OpenHarmony and Android devices in the same workflow.
  • Mirror multiple devices at the same time and compare UI state.
  • Connect devices over a local network instead of frequently plugging cables.
  • Deliver a ZIP package or offline Chocolatey package for Windows environments.
  • Route devices correctly when serial values or toolchains are ambiguous.

Device Detection and Routing

By default, users can specify the device serial directly. The launcher detects whether the target is Android or OpenHarmony. If the same serial is available through both ADB and HDC, Android is preferred. If ADB is offline or unauthorized while HDC is online, OpenHarmony is selected.

Users can also force the platform with -Platform Android or -Platform OHOS.

Device routing

Installation

Release assets include three file types:

  • ohscrcpy-windows-x64-<version>.zip: extract and run ohscrcpy.cmd.
  • ohscrcpy.<version>.nupkg: self-contained Chocolatey offline package.
  • SHA256SUMS-v<version>.txt: package checksums.

Offline install

Common Commands

ohscrcpy -s <ohos-device-serial>
ohscrcpy -s <android-device-serial>:5555
ohscrcpy -m "<android-device-a>:5555,<android-device-b>:5555"
ohscrcpy -m "<ohos-device-a>,<ohos-device-b>" -q Clear

-s connects a single device, and -m connects up to 9 comma-separated devices. Common options also include -Quality, -Codec, -Fps, -Bitrate, --version, and --help.

Quality and Requirements

Android -Quality Clear defaults to a maximum long edge of 1920, 20 fps, and 8 Mbps. Low-resolution devices keep their native size and use a higher bitrate to reduce compression artifacts.

The tool requires Windows 10/11 x64. OpenHarmony devices require hdc.exe in PATH; Android devices require Android SDK Platform Tools adb.exe in PATH.