Skip to content

kil0bit-kb/scrcpy-gui

Repository files navigation

ScrcpyGUI Icon

ScrcpyGUI v4

A premium, high-performance Android control experience.

ScrcpyGUI Interface


ScrcpyGUI v4 is a modern, feature-rich GUI for scrcpy, completely rebuilt from the ground up using Tauri v2, React 19, and Rust. It transforms your Android device into a professional tool for gaming, development, and content creation.

🚀 Key Features

  • ✨ Best Looking GUI: A stunning, modern interface with smooth animations and a premium look and feel.
  • 🎨 Custom Theme Engine: 5 premium, hand-crafted themes including Ultraviolet, Astro, Carbon, Emerald, and Bloodmoon to match your workspace setup.
  • 🔄 Automated Binary Updates: Deep-integrated system that automatically checks if your local scrcpy binary is outdated compared to Genymobile's latest official release, prompting you with a beautiful one-click update modal.
  • 🎮 Precision Input (OTG):
    • HID Keyboard: Native hardware simulation for international layouts and special characters.
    • HID Mouse: Zero-lag, high-precision cursor control for a "native desktop" feel.
  • 🖥️ Graphics Renderer Selection:
    • Choose a renderer backend such as Direct3D, OpenGL, OpenGL ES, Metal, or Software (capability-aware, OS-filtered).
  • 🌐 Seamless Connectivity:
    • Wireless Pairing: Native UI for Android 11+ wireless pairings.
    • Connection History: Remember and reconnect to wireless devices with one click.
  • 📹 Pro Camera Mode (Webcam):
    • Refresh Lenses: Click to automatically scan and list all physical camera sensors, resolutions, and zoom ranges.
    • Torch & Zoom: Toggle your device's flashlight or adjust zoom level (1.0x - 5.0x) natively.
    • Failsafe Camera-Size: Automatically maps resolutions and defaults to safe 1080p dimensions, preventing hardware encoder crashes on high-megapixel devices.
  • 🖥️ Desktop Mode (Virtual Display):
    • Flex Display: Drag and resize your virtual desktop window dynamically on the fly!
    • Background Colors: Customize scrcpy's border and letterbox color with hex values and a live color swatch.
    • Keep Active: Periodic user activity simulator preventing device sleep without changing global settings.
  • 📁 Fluid File Management:
    • Drag & drop APK installation or file pushing directly to /sdcard/Download/.
  • 🖼️ Premium UX:
    • Splash Screen: Zero-flicker, themed startup experience.
    • Smart Folder Picker: Automatically falls back to local scrcpy-bin or application executable directories when browsing folders.

📖 Getting Started

To learn how to enable USB Debugging, set up Wireless Pairing, or install requirements, please read our comprehensive guide:


🛠️ Development

Prerequisites

Build Instructions

  1. npm install
  2. npm run tauri dev (Development)
  3. npm run tauri build (Production)

❄️ NixOS Installation (flakes)

To install it permanently with a desktop launcher, add the flake to your system's flake.nix:

inputs.scrcpy-gui.url = "github:kil0bit-kb/scrcpy-gui";

Then add it to your system packages:

environment.systemPackages = [
  inputs.scrcpy-gui.packages.${pkgs.system}.default
];

💖 Support the Project

If ScrcpyGUI helps you in your daily workflow, consider supporting its development on Patreon. Your support keeps the project alive and independent!

Support on Patreon


� Acknowledgments

ScrcpyGUI is made possible by the following amazing open-source projects:

  • scrcpy: The ultra-fast core engine.
  • Tauri: The secure, lightweight framework for the desktop app.
  • Lucide Icons: For the clean and consistent iconography.
  • React: Powering the modern, interactive interface.

�📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

ScrcpyGUI is an independent project and is not affiliated with Genymobile or scrcpy authors.

About

A modern, high-performance GUI for the scrcpy

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors