scrcpy-mirror-control README

The project's README from github.com/SirBonney/scrcpy-mirror-control. As one markdown file: 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)

Searching Database…

What is this?A Windows desktop tool that shows an Android phone's screen in a window on your PC and lets you control it with your mouse and keyboard.
Is it an app I install or a library?It's an app: a desktop console that pushes a small companion agent onto the phone the first time you connect it.
How do I get it running?Enable USB debugging in the Android developer options, plug the phone in with a data cable, tap Allow once on the phone, then launch the tool and the mirror window appears.
What do I need before starting?Windows 10 or 11, PowerShell 5.1 or newer, a network connection, and no admin rights. The README says the rest is bundled in the package.
Any install warnings I should know about?The README admits antivirus heuristics may flag the prebuilt binaries and tells you to allow them. Check where you downloaded it before you do.
Does it work on macOS or Linux?No, the README lists only Windows 10 and Windows 11.
What does this add on top of plain scrcpy?According to the README it bundles the server component, a companion display client, and the drivers and runtimes into one portable folder, so you don't have to assemble the pieces yourself.
Can I mirror several phones at once?Yes, each connected device opens its own window, so you can place several phones side by side on the desktop.
What can I do besides mirroring?You can copy text from phone to desktop, drag files between the two, take screenshots, record the session, and resize or rotate the mirror window.
Creator
SirBonney
Size
0.5 MB
Stars
1.1K
Updated
CommitNov 17
Age
12d
Commits Β· 90 Days