ScrcpyGUI v4.0.0

scrcpy v4.0 Native UI Controls:

Flex Display (-x): Dynamic software desktop resizing in Desktop Mode.
Camera Torch & Zoom: Full slider and toggle capabilities for device sensors.
Keep Active: Non-intrusive wake locks to prevent screen sleep.
Background Color: Swatch-preview custom border/letterbox colors.

Dynamic Update Manager:

Asynchronous mount-time update comparisons of scrcpy --version against official GitHub /releases/latest APIs.
Stunning, side-by-side dark glassmorphic confirmation prompt offering dynamic auto-upgrades and custom path hot-swaps.

Failsafe Camera Lens Launcher:

Full-width, auto-populating specific device camera lens lists (back vs. front sensors, resolutions, zoom, FPS) via dynamic Refresh Lenses triggers.
Auto-maps resolutions to standard formats and injects a failsafe 1080p camera-size default (1920x1080), completely preventing hardware encoder crashes on high-megapixel sensors (such as your native 4080x3060 back lens).
Added Auto / Default select mapping to dynamically omit both --camera-fps and --max-fps CLI parameters.

Security Auditing & Hardening:
Pinned exact dependencies to secure package installations.
Secured recursive path traversal vectors inside directory duplication helpers.
Hardened the translation lookup keys against prototype pollution vectors.

Multi-Language Support:
Added fully-translated locale assets across English, French, Portuguese, Russian, Simplified Chinese, and Traditional Chinese.

ScrcpyGUI v3.5.4

What's Changed

• Add audio codec selection and automatic fallback by @Victor-root in #74

ScrcpyGUI v3.5.2

*Add light mode and system color mode by @Victor-root in #71

• Add i18n support with English, French and Brazilian Portuguese translations by @Victor-root in #69

ScrcpyGUI v3.5.0

What's Changed

• feat: add capability-aware graphics renderer selection for scrcpy-gui by @therollo9 in #65

New Contributors

• @therollo9 made their first contribution in #65

Full Changelog: v3.4.4...v3.5.0

ScrcpyGUI v3.4.3

🚀 Scrcpy Engine Hardening & Workflow Fix (v3.4.3)

🛠️ Bug Fixes

Engine Hardening: Enhanced the binary discovery logic to strictly verify file existence across multiple locations (Custom Path, Bundled, and System Path). This prevents "Access Denied" errors when a directory is incorrectly targeted instead of a binary.
Explicit Environment Injection: The app now explicitly sets ADB and SCRCPY_SERVER_PATH environment variables for every session. This ensures scrcpy always finds its own internal dependencies regardless of system-wide settings.

Configuration Persistence: Fixed a race condition in the initialization logic that occasionally caused custom path settings to reset to defaults on startup.
CI/CD Release Sync: Resolved a logical error in the versioning automation where GitHub tags were trailing one version behind the actual code.

✨ Technical Improvements

Enhanced Traceability: Added detailed logging of the absolute paths for both scrcpy and adb at the start of every session to aid in troubleshooting.

Backend Stability: Fixed Rust borrow checker issues in the command engine and updated project metadata to v3.4.3.

ScrcpyGUI v3.4.0

versioning fix across the app ui and more...

ScrcpyGUI v3.3.0

🚀 ScrcpyGUI v3.3.0 - Input Precision & Performance Boost
This release moves ScrcpyGUI v3 into a professional-grade state with major performance optimizations, independent HID hardware simulation, and a fully automated CI/CD pipeline.

🌐 Cross-Platform Expansion
macOS Premiere: We are excited to announce the first-ever macOS release (Universal binary for Intel & Apple Silicon)!
Linux Support: Official .deb, .rpm, and .AppImage bundles are now available.
IMPORTANT

Platform Status: While the Windows version is fully tested and stable, the macOS and Linux builds are currently in a "preview" state and have not been exhaustively tested.

If you encounter any bugs or display issues on these platforms, please Submit an Issue so we can iron them out!

🎮 Input Enhancements & Precision
Independent HID Controls: You can now toggle HID Keyboard and HID Mouse independently.
HID Keyboard: Simulates a physical keyboard to fix international layout issues (e.g., Polish diacritics).
HID Mouse: Provides hardware-level high-precision cursor control, eliminating lag and jitter.
Pure HID Fix: Correctly disables screen mirroring and audio when purely using PC input (OTG mode).
⚡ Performance & Efficiency
Log Batching: Implemented a 100ms log buffer in the Rust backend, reducing IPC frequency by ~90% and drastically lowering CPU usage.
Memoized UI: The Log Panel and main interface are now memoized to prevent redundant re-renders.
Zero-Flicker Startup: Optimized the splash screen synchronization to eliminate the "white flash" on launch.
🎨 Design & UX
Theme Contrast System: New global contrast logic ensures perfect readability (Black/White text) on all primary elements across all themes (Carbon, Ultraviolet, etc.).
Simplified Onboarding: The setup checklist now only appears if binaries are missing, with a proactive "System Health" indicator in the header.
🛠️ Infrastructure
CI/CD Automation: Fully automated version bumping and release draft generation via GitHub Actions using the new RELEASE_TOKEN pipeline.
Build Stability: Fixed Linux dependency issues and updated critical Rust crates for maximum security and reliability.
Thank you for using ScrcpyGUI! 🤝🏾❤

Scrcpy GUI v1.0

This release delivers a stable and polished build of Scrcpy GUI, focusing on performance, usability, and a smooth out-of-the-box experience for mirroring and controlling Android devices on desktop.

✨ What’s Included

🪞 Low-latency Android screen mirroring powered by scrcpy

🎮 Full mouse & keyboard control

📡 USB and Wireless (TCP/IP) connectivity

🎥 Advanced video configuration

Resolution up to 1080p

Frame rate up to 120 FPS

Bitrate up to 24 Mbps

📦 Quick APK installer

Drag & drop .apk files to install instantly

🎛️ One-click mirroring presets

Stay Awake

Screen Off

System Audio

Desktop Mode

⌨️ Built-in shortcut reference panel

🧳 Portable mode

Use local scrcpy binaries without system-wide installation

📦 Prebuilt Binary

This release includes ready-to-use builds.
No Node.js or build steps required — just download and run.

👉 Ideal for users who want a simple plug-and-play experience.

🔧 Requirements

Official scrcpy binaries (v2.0+ recommended)
👉 https://github.com/Genymobile/scrcpy/releases

ADB drivers installed

USB Debugging enabled on your Android device

📝 Notes

First release

Tested on Windows with official scrcpy binaries

Future updates will focus on UI refinement and feature expansion

⭐ Support

If you find this project useful, consider starring the repository and sharing feedback to help improve future releases.

ScrcpyGUI v3.1.0 biggest update

Features & Improvements

• Tauri v2 Migration: Completely rewritten with React and Rust for a faster, more secure, and lightweight experience.
• Modern UI: A fresh, redesigned interface focused on better usability and modern aesthetics.
• Fresh New Icon: Updated branding with a new high-resolution app icon.
• Linux Support: Added AppImage builds for Linux users.
• Windows Builds: Available in MSI, NSIS, and Portable formats.

Troubleshooting & Setup

• scrcpy Download: If the app fails to download scrcpy automatically, please try running the app as Administrator.
• Manual Setup: You can also download scrcpy manually, then use the Browse button in the app to select the executable.
• Help: Click the Setup Help option at the top of the app for more detailed information.

Testing Status

• Windows: Fully tested and verified.
• Linux: Partially tested on Ubuntu and ZorinOS (confirmed working).
• macOS: Prebuilds are planned for the near future.

v3.0 - The .NET Evolution

🚀 Scrcpy GUI v3.0 - Full Migration to .NET

We are excited to announce Scrcpy GUI v3.0! This release marks a major milestone: we have completely rebuilt the application from the ground up, moving away from Electron to a high-performance .NET 10 (WPF + WebView2) architecture.

🌟 What's New in v3.0

🏗 Engine & Performance

• Electron → .NET 10: Significant reduction in memory usage and improved startup speed.
• Integrated Downloader: No more manual setup! The app now auto-detects your PC architecture (x64/x86) and downloads the required scrcpy binaries directly.

📱 Mirroring & Control

• Expanded Modes: Support for Standard Mirroring, High-Speed Camera View, Desktop Mode (Android 16+), and Pure OTG Mode (USB & Wireless).
• Advanced Camera Support: Choose specific sensors (Main, Ultra-wide, Macro) using Camera IDs and use H.265 (HEVC) for high-frame-rate stability.
• One-Click Screenshots: Capture your phone screen directly to your PC's Pictures folder.

📁 File Management

• Universal Drag-and-Drop: Drag any file onto the GUI to push it to your phone's /sdcard/Download folder instantly. APKs are still automatically installed.

🎨 Customization

• New Theme Switcher: 5 professionally designed themes (Ultraviolet, Astro Blue, Carbon Stealth, Emerald Stealth, and Blood Moon).
• Device Nicknames: Set custom names for your devices to replace cryptic serial numbers.
• Intelligent Hints: Modern, multi-line hint boxes for every setting.

📥 Which file should I download?

• Setup.exe: Best for most users. Full installer that works on any PC.
• Portable_x64.zip: For modern 64-bit Windows PCs (No installation needed).
• Portable_x86.zip: For older 32-bit Windows PCs.
• Portable_ARM64.zip: For Windows on ARM devices (Surface Pro, etc.).