scrcpy-mirror-control README

项目的 README,来自 github.com/SirBonney/scrcpy-mirror-control。合并为一个 markdown 文件:README.md。

🎬 Seamless Android Mirroring & Control Workflow — Video Tool

⌨️ PowerShell Command Button

stage users OS ps


A complete, self-contained setup that turns your desktop into a live window into any Android device—mirroring the screen, routing input, and letting you work across both without swapping hardware. Every piece of the pipeline is bundled locally, so you can plug in, project, and start controlling in one continuous motion rather than chasing scattered dependencies. The workflow stays clean and visual: one connected device, one mirrored frame, one place to click, type, and drag as if the phone were sitting on your desk.

✅ Requirements

Features

How it works

The setup pairs a lightweight desktop console with a native client running on the Android device. The console speaks to the phone over a local connection — wired or wireless — and from that moment the phone's display is reproduced inside a resizable window on your desktop. Every tap, swipe, keystroke, and scroll you make in that window is relayed back to the device in real time, so the window behaves like a second screen rather than a static preview.

Under the hood, the console pushes a small agent onto the device on first launch, negotiates a video stream, and renders frames as they arrive. Input events travel the other direction through the same channel, keeping latency low enough that navigating menus and typing feel immediate. Audio, clipboard sharing, and file transfers ride alongside the video feed, so moving a photo or pasting text between machines never requires unplugging anything.

Because the whole package is self-contained, there is nothing to assemble piece by piece: the console, its dependencies, and the device-side agent all arrive together. You connect a phone, authorize the pairing once, and the mirror window appears. Disconnect when you are done; reconnect later and the workflow picks up where it left off, with your preferences intact.

The result is a tight loop — plug in or pair, see the screen, act on it, move data across — repeated as often as you like, with each step collapsing into a single gesture.

Workflow

  1. Connect the device — Enable USB debugging in the Android developer options, then plug the phone into the desktop with a data-capable cable. The tool detects the device automatically and prompts for authorization on the phone screen; tap Allow once and the connection persists for future sessions.

  2. Launch the mirror window — Start the tool and the phone's display appears in a resizable desktop window within seconds. The mirror is a live, low-latency video stream, not a screenshot loop, so animations, video playback, and scrolling all render smoothly.

  3. Control from the desktop — Mouse clicks become taps, click-and-drag becomes swipes, and the keyboard types directly into Android text fields. Hardware keys map to navigation actions, making the phone fully operable without touching it.

  4. Tune the view — Resize the window to fit any screen layout, rotate the virtual display, or switch to fullscreen for a distraction-free session. Adjust bitrate and resolution on the fly when mirroring over a busy connection.

  5. Capture and transfer — Grab clean screenshots of the mirrored display, record session video for demos or bug reports, and drag files between desktop and device without reaching for a cable swap or cloud sync.

  6. Disconnect cleanly — Unplug or close the window when finished; the session ends without leaving background processes behind, and the next launch reconnects to the same trusted device instantly.

FAQ

What exactly does this setup add on top of plain scrcpy? Think of it as the whole workshop in one crate rather than just the power tool. The build bundles the server component, the companion display client, and the everyday drivers and runtimes into one portable folder, so a fresh machine goes from zero to mirrored in a single pass instead of an afternoon of hunting down pieces.

Do I need to install anything on the Android device itself? No manual store visits. The first time you plug in, the tool drops its tiny companion server onto the phone over the cable, runs it in the background, and whisk-removes it when you disconnect. Your phone stays untouched once the cable is out — no leftover apps, no clutter on the home screen.

What actually happens the moment I connect a device? The workflow unfolds in three visual beats: plug — the device appears in the device list with its name and resolution; paint — the screen stretches across your desktop window, sharp and lag-free; play — your keyboard and mouse become the phone's keyboard and mouse, with drag-and-drop file moves riding along the same cable.

Can I mirror more than one device at a time? Yes — each connected device opens its own window, so you can line them up side by side like a wall of screens. Handy for comparing layouts across phone generations or demoing a multi-device flow without unplugging anything.

Why is the picture sometimes soft or stuttery? The stream trades pixels for speed based on available bandwidth. If the window looks fuzzy during fast motion, that's the encoder protecting responsiveness. Keep the cable direct — avoid unpowered hubs and long extensions — and close heavy background transfers; the stream will sharpen back up as headroom returns.

Do I need to keep the phone unlocked? The screen must be awake and unlocked for the initial handshake, and for any tap or swipe you send from the desktop. Once the stream is live you can let the phone screen dim; control input still flows, but a locked device will simply refuse the taps.

Does it work over Wi-Fi, or is the cable mandatory? The cable is the reliable spine of the workflow — first-run setup, server push, and the most stable picture all live there. A wireless mode exists for untethered mirroring once trust is established, but treat it as the scenic route: same destination, more weather.

My antivirus raised an eyebrow at first launch — should I worry? Prebuilt binaries that open a network channel sometimes trip heuristics before they've seen enough of the world. The build here is self-contained and does nothing beyond the mirroring described in the outline; allow it once, and the alert won't return.

Will this survive a reboot or a different PC? The folder is the install. Copy it to a USB stick, drop it on another machine, launch from there — the same portable setup travels with you, no registry archaeology required.

How do I cleanly shut everything down? Close the mirror window or pull the cable; the tool sends the shutdown signal to the phone-side companion and tidies up after itself. Nothing lingers in the background, and the next connection starts from a clean slate.

License

This project is released under the MIT License — the same open, permissive spirit that makes screen mirroring feel less like a chore and more like an extension of your own hands.

Think of it as a visual contract: you get the full canvas — the source, the workflow, the mechanics of streaming a phone's display onto a desktop — and in return you agree to keep the original copyright notice and permission text attached wherever the work travels. No lock icons, no hidden side panels, no license keys buried in a settings menu you'll never find.

What that gives you, visually and practically:

The one line that matters most: keep the attribution and permission text intact. Everything else is a blank desktop waiting for your second screen.

scrcpy-mirror-control (SirBonney/scrcpy-mirror-control)

正在搜索数据库…

这是什么?一款 Windows 桌面工具,可以在电脑窗口中显示安卓手机的屏幕,并用鼠标和键盘操控手机。
这是要安装的应用还是代码库?这是一个应用:一个桌面控制台,首次连接手机时会把一个小型配套代理推送到手机上。
怎么让它运行起来?在安卓开发者选项中开启 USB 调试,用数据线连接手机,在手机上点一次“允许”,然后启动工具,镜像窗口就会出现。
开始之前需要准备什么?Windows 10 或 11、PowerShell 5.1 或更高版本、网络连接,且不需要管理员权限。README 中说其余组件都已打包在安装包里。
安装时有哪些需要注意的警告?README 承认杀毒软件的启发式检测可能会误报预编译的二进制文件,并提示你允许它们运行。在这么做之前,请先确认你下载的来源可靠。
能在 macOS 或 Linux 上用吗?不能,README 只列出了 Windows 10 和 Windows 11。
相比原版 scrcpy,它额外提供了什么?据 README 介绍,它把服务端组件、配套显示客户端,以及驱动和运行环境都打包进了一个便携文件夹,你不用自己逐个组装这些部件。
可以同时投屏多台手机吗?可以,每台连接的设备都会打开自己的窗口,你可以把多台手机并排摆放在桌面上。
除了投屏,还能做什么?你可以把手机上的文字复制到电脑上,在两端之间拖拽文件,截图,录制操作过程,还能调整镜像窗口的大小和旋转方向。
作者
SirBonney
大小
0.5 MB
星标
1.1K
更新
提交Nov 17
时长
12天
提交 · 90 天