yiyifred/cloud-phone

Cloud Phone is a self-hosted web application that lets you view and control Android phones from a browser on your local network. You run a small Node.js server on a computer connected to one or more Android devices via USB, then open a browser tab to see a live video feed of each phone's screen and interact with it using your mouse and keyboard. The README is written primarily in Chinese but an English version is linked. The tool builds on scrcpy, a widely used open-source Android screen mirroring library, and extends it with a web-based interface. Video is streamed over WebSocket and decoded directly in the browser using a modern browser feature called WebCodecs, which means the live view works in Chrome and Edge without plugins. Input events you make on the browser canvas (taps, swipes, button presses) are sent back to the phone using the same protocol scrcpy uses. Beyond screen mirroring, the web interface includes a file manager for browsing and transferring files to and from the phone, an app manager for installing and uninstalling APKs, and a terminal that gives you a shell on the device. Camera streaming is also supported on Android 12 and above, with controls for flashlight and zoom. The interface supports multiple languages including English, Japanese, and Korean, and uses session-based login with encrypted API communication. A companion Android app is also included in the repository. It connects to the same backend server and provides device browsing and full-screen mirroring from a phone rather than a desktop browser. The Android app supports pairing new devices by QR code or pairing code. Installation scripts are provided for Linux, macOS, and Windows. The only hard requirements are Node.js 18 or later on the server machine and a Chromium-based browser for the web client.