Skip to content

kil0bit-kb/scrcpy-gui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

124 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

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