How akichase/scrcpy-mask works
Project type and purpose
• This is a cross-platform desktop control client built with Tauri (Rust) on the backend and Vue 3/Vite on the frontend.
• Its sole purpose is to implement the Scrcpy control protocol (no built-in video mirroring) and allow millisecond-level mouse/keyboard mapping to Android devices (physical or emulator), optionally using an external LAN mirroring service like ScreenStream.
File structure
• Top-level:
• package.json, vite.config.ts, tsconfig.json → front-end build & dev config
• public/index.html, src/… → Vue 3 single-file components + TypeScript code for UI, routing, state, styles
• src-tauri/ → Tauri Rust backend + resource files
• src-tauri/Cargo.toml, build.rs → Rust project definition and custom build steps
• src-tauri/src/*.rs → core Rust modules:
— adb.rs: ADB device discovery & connection
— client.rs, socket.rs, share.rs, control_msg.rs, scrcpy_mask_cmd.rs: Scrcpy control protocol implementation & IPC
— main.rs & lib.rs: tauri app initialization, command registration
• publish.js, .github/workflows/publish.yml → CI/CD & release automation
Key README insights
• Emphasis on millisecond-level input control via Tauri command bindings.
• Supports both wired (ADB) and wireless ADB over TCP.
• Optional integration with ScreenStream for real-time video overlay.
• External control API exposed via WebSocket.
• Configuration import/export of key mappings and macros.