Releases: viarotel-org/escrcpy
Release list
v3.0.8
🚀 Escrcpy 3.0.8 — Smarter Device Control & Automation
Escrcpy 3.0.8 is the first official public release of the 3.0 series.
This release focuses on three major directions: intelligence, automation, and efficient device management.
It introduces the brand-new Shortcut module for faster device operations, enhances the file manager with Quick Access, adds visual recognition-based automation judgment, and introduces a new MCP (Model Context Protocol)-based AI automation architecture.
In addition, this release brings significant improvements to keyboard and mouse mapping, preference management, AI Copilot experience, MCP stability, build infrastructure, and overall system reliability.
With these upgrades, Escrcpy continues evolving from a traditional device control tool into a smarter, more efficient, and more extensible device automation platform.
✨ Major Highlights
⚡ New Shortcut Module — Instant Device Operations
A brand-new Shortcut module is introduced to provide a faster and more convenient way to perform frequently used device operations.
Key capabilities:
-
Execute common device actions instantly through keyboard shortcuts
-
Perform shortcut operations on specific devices
-
Quickly trigger actions including:
- Start device mirroring
- Start screen recording
- Execute frequently used device commands
- Run automation tasks
The previous scheduled task system has also been redesigned and deeply integrated with the Shortcut module.
By combining instant actions and scheduled automation into a unified workflow system, Escrcpy makes it easier to create, manage, and execute device automation tasks.
From simple quick operations to complex automation workflows, Escrcpy now provides a more efficient device control experience.
📁 Enhanced File Manager Experience — Quick Access & Smart Sorting
The file manager has received a major usability upgrade with the introduction of Quick Access.
New capabilities:
-
Quickly access frequently used files and folders
-
Support favorites:
- Add frequently used files to favorites
- Add frequently used folders to favorites
-
Support recent access history:
- Quickly return to recently used locations
- Reduce repeated navigation operations
The default sorting behavior has also been redesigned to better match user expectations:
- Folders are displayed before files
- Items are sorted alphabetically
- Provides a more natural and intuitive browsing experience
These improvements make device file management faster and more efficient.
👁️ Visual Recognition for Smarter Automation Scripts
The automation script editor now supports image recognition-based conditional logic, enabling smarter and more flexible automation workflows.
New capabilities:
- Detect whether specific content appears on the screen
- Execute different actions based on recognition results
- Build more complex conditional automation processes
Compared with traditional coordinate-based automation, visual recognition provides better adaptability across:
- Different device resolutions
- Different interface layouts
- Dynamic application states
Automation scripts are no longer limited to fixed step execution — they can now analyze device status and respond intelligently.
🤖 MCP-Based AI Automation Architecture
Escrcpy 3.0.8 introduces a new MCP (Model Context Protocol)-based AI automation architecture.
Compared with traditional solutions built around a single AI model, the new architecture provides a more open and extensible AI integration framework.
Key improvements:
- Support more AI models with visual understanding capabilities
- Remove dependency on a single AI model solution
- Enable more flexible AI capability extensions
- Improve compatibility with future AI ecosystems
New AI management features:
- AI conversation session management
- Custom model configuration
- Custom AI provider support
This release also improves MCP communication and reliability:
- Optimized MCP Client internal logic
- Improved MCP service stability
- Fixed MCP Server startup issues in packaged environments
With MCP architecture, Escrcpy provides a stronger foundation for future intelligent device interaction.
🎮 Complete Keyboard & Mouse Mapping Reconstruction
The keyboard and mouse mapping system has been completely redesigned to provide a more stable and natural control experience.
This release addresses several historical issues:
- Fixed touch interruption during long-press mappings
- Improved multi-touch support
- Enhanced stability in complex input scenarios
- Improved overall mapping experience
The new mapping system provides more reliable control, especially for gaming and scenarios requiring complex interactions.
⚙️ Preference System Redesign
The global and device-specific configuration system has been redesigned.
Improvements include:
- Reorganized configuration structure
- Clearer separation between global settings and device settings
- Improved configuration management logic
- More intuitive settings experience
This resolves previous issues where configuration relationships were difficult to understand and manage.
Users can now easily find, modify, and manage Escrcpy settings.
🧠 AI Copilot Experience Improvements
The AI Copilot system has received continuous improvements:
- Optimized Copilot interaction details
- Improved AI conversation experience
- Optimized system prompt logic
- Reduced unnecessary reasoning loops caused by unclear context
- Improved AI task execution stability
These improvements help AI better understand user intentions and complete device operations more reliably.
⚡ Performance Improvements
- Improved AI Copilot overall performance
- Optimized MCP Client logic
- Enhanced MCP service reliability
- Optimized image recognition and matching algorithms
- Improved automation script editor experience
- Improved Shortcut module execution efficiency
- Optimized automatic mirroring startup flow
- Optimized sub-package build logic
- Improved project build performance
- Updated automatic release scripts
- Optimized cumulative subscription recharge calculation logic
- Removed redundant dependencies and improved maintainability
🎨 UI / UX Improvements
- Improved AI conversation interface
- Optimized Shortcut module interaction experience
- Improved scheduled task management experience
- Enhanced file manager usability
- Improved command execution and terminal presentation
- Refined overall UI consistency
🐛 Bug Fixes
- Fixed keyboard mapping touch interruption issues
- Fixed multi-touch mapping failures
- Fixed Shortcut module configuration import issues
- Fixed shortcut configuration saving issues
- Fixed AI model default configuration initialization issues
- Fixed AI response display problems
- Fixed custom executable configuration not taking effect
- Fixed batch mirroring startup window issues
- Fixed screenshot orientation issues
- Fixed casting scroll direction issues
- Fixed MCP Server startup failures after packaging
- Fixed GitHub Actions build issues
- Fixed dependency build problems
🏗 Architecture & Infrastructure
- Introduced MCP foundations for AI-powered device control
- Improved MCP module design and reusability
- Enhanced mscrcpy stability
- Optimized modular architecture
- Improved build and release workflows
- Increased code maintainability and long-term scalability
v2.11.1
2.11.1(2026-05-12)
Features
- ⚡️ Optimizations for enabling device application interaction include adding display presets
- 🚀 Update to scrcpy 4.0
Bug Fixes
- keyboard: align click hold behavior and improve view control
- 🐛 Fixed the issue where mouse mapping cannot be triggered simultaneously when multiple components exist
Performance Improvements
- 🚀 Solve the problem that binary dependency caching may cause program anomalies after version upgrades
Code Refactoring
- ➖ Remove redundant code
- 👷 Optimize the preference interactive experience
- 🚀 Reconstruct the keyboard mapping module lifecycle skeleton to improve scalability
- ➖ Removed redundant option for keyboard mapping perspective control
- 🚀 Keyboard mapping and viewing angle control function reconstruction and optimization
- 🚀 Update the sorting of dependency imports
v2.10.2
2.10.2 (2026-05-12)
Features
- ⚡️ Added automatic discovery support to scan and connect all available devices within the LAN automatically
- ✨ Embedded mirroring now supports keyboard mapping functionality
- 🎉 Added perspective control, mouse mapping, and random range configuration support for keyboard mapping
Bug Fixes
- 🐛 Fix i18n variable declaration exceptions
- 🐛 Fixed the issue where embedded audio forwarding was not cleared after closing the window
- 🐛 Fix the app startup list search box jitter problem
- 🐛 Fixed normalized boundary calculation issues for keyboard mapping coordinates
- 👷 Fix dependency update issues
Performance Improvements
- ♻️ Optimize automatic discovery logic to exclude already connected devices
- ✨ Optimize embedded mirroring keyboard mapping interaction details
- 🚀 Improve app startup performance for loading device and app list data
- 🚀 Improve the reliability and stability of wscrcpy and embedded mirror group control
- 🚀 Keymap macros now support automation script execution
- 🚀 Optimize keyboard mapping interaction details and rendering performance
- 🚀 Optimize keyboard mapping module interaction and visual effects
- 🚀 Improve synchronization between embedded mirror rotation and device rotation
- 🚀 Improve sub-window naming rules
- 🚀 Keyboard mapping now supports switch hotkeys for temporary enable and disable control
- 🚀 Optimize keyboard mapping performance and trigger response speed
- 🚀 Optimize keyboard mapping switch hotkey interaction details
- 🚀 Optimize subscription page interaction effects
- 🚀 Keyboard mapping trigger logic now supports Extreme Speed Mode and Natural Mode
Code Refactoring
- ♻️ Refactor and modularize wscrcpy functionality
- 👷 Refactored scheduled task module now supports application restart recovery
- 🔧 Replace custom shell escaping implementation with the safer shell-quote library
- 🚀 Improve execution performance and reliability of batch automation image tasks
- 🚀 Optimize subscription system token storage logic
- 🚀 Reconstruct the keyboard mapping module architecture to improve maintainability and performance
- 🚀 Refactored keyboard mapping key input logic for more flexible configuration support
v2.9.0
2.9.0 (2026-04-24)
Features
- 🚀 Fully support independent configuration for app startup (2d7c632)
- 🚀 Supports launching Android multi-user/clone applications and provides independent landscape secondary screen launch options for applications (67612d9)
Bug Fixes
- 🐛 Fix the problem that the app startup is affected by window arrangement from the root (2a1f846)
- 🐛 Fixed the interaction experience problem of the operation button at the top of the scheduled task list (dc7bcbc)
- 🐛 Fixed the issue where clicking the Cancel/Save button did not respond when editing files in file management (8df5822)
- 🐛 Fixed the issue where the app launch was affected by window arrangement (540d813)
- 🚀 Solve the problem of incompatible window arrangements for embedded mirror (d651412)
Performance Improvements
v2.8.1
v2.8.0
2.8.0 (2026-04-06)
Features
- ✨ Window arrangement supports the automatic arrangement function (696d94b)
Bug Fixes
- 🐛 Fix i18n errors (e4ad3ec)
- 🐛 Fix the default value issue of the subscription plan (a19dd9e)
- 🐛 Fixed the issue where multiple files cannot be pasted when copied to the clipboard under Windows (dcc7a94)
Performance Improvements
- ♻️ Optimize subscription plan (c12ef9d)
- ♻️ Optimize the pricing strategy for advanced features to prevent misjudgments by users (4d722b7)
- 💄 Optimize the display details of the embedded mirror window (6cf4c69)
- 🚀 Automation script adds random range option (4d73e1a)
- 🚀 Extended embedded mirroring operable shortcut buttons (19c0de2)
- 🚀 Optimize subscription configuration (d053bfa)
- 🚀 Optimize the automation script editor to avoid screen border issues (ffd56a6)
- 🚀 Refactored file copy function supports batch copying to the clipboard (ccca99a)
Code Refactoring
v2.7.3
2.7.3 (2026-04-02)
Bug Fixes
- 🐛 Fixed an issue where embedded mirroring could not be input due to external activation elements. (058b982)
Performance Improvements
- 🚀 Optimize the embedded image to open the application list display (7f6b18a)
Code Refactoring
- 🔊 Optimize the wscrcpy audio cleaning logic (a29cd85)
v2.7.0
2.7.0 (2026-04-01)
This release introduces two flagship capabilities: Built-in Embedded Mirroring, which renders Android device screens directly inside the app window without launching any external processes, and Device Group Control, which enables synchronized multi-device operation from a single interface — including batch launching, keyboard forwarding, and real-time interaction sync across all connected devices. Both features are powered by the new proprietary wscrcpy package, a web-native Android screen rendering engine built on top of tango-adb. Numerous stability and interaction improvements have also been made across the board.
🎉 Major New Features
- Introduced built-in embedded mirroring: device screens are now rendered directly within the app window, eliminating the need to open separate external windows.
- Introduced device group control: multiple devices can now be operated in sync, with support for batch launching, keyboard input forwarding, and synchronized interaction across all connected devices.
- Added a redesigned guide page for the embedded mirroring module to improve onboarding clarity.
- Added mouse hover monitoring support to embedded mirroring.
- Audio forwarding in embedded mirroring is now enabled by default on macOS only, avoiding conflicts on other platforms.
- Added more embedded launch entry points directly from the device list for quicker access.
🐛 Bug Fixes
- Fixed an issue where the mirror module window position was incorrectly reset on startup.
- Fixed data echo (duplicate display) issues occurring in automation script steps.
- Fixed audio forwarding exceptions in embedded mirroring.
- Fixed group control failure when using embedded mirroring as the backend.
- Fixed clipboard synchronization issues in embedded mirroring.
- Fixed reconnection failures in embedded mirroring after connection drops.
- Fixed build conflicts and misalignment issues between sub-packages.
- Fixed a syntax error in the embedded mirroring module's bottom action bar.
- Fixed incorrect size ratio calculation when switching the primary device in group control view.
- Fixed an abnormal video stream disconnection when exiting the program while embedded mirroring was active.
- Fixed interaction forwarding conflicts when group control is enabled on auxiliary devices.
- Fixed button forwarding issues in the embedded mirroring adapter.
- Fixed screen rotation handling in the embedded mirroring module.
- Fixed a configuration conflict between embedded mirroring audio forwarding and clipboard synchronization.
⚡ Experience & Performance Improvements
- Optimized the overall interaction experience of the embedded mirroring module, including smoother click and swipe event handling.
- Expanded group control to support more operation types, including broader batch actions and improved subscription capabilities.
- Optimized the keyboard input experience within the group control module.
- Improved the interactive control bar of embedded mirroring for more intuitive in-session operation.
- Optimized the video stream freeze issue that occurred when launching embedded mirroring on an already-connected device.
- Improved the stability of the embedded mirroring adapter across edge cases.
- Optimized embedded mirroring input handling through a full reconstruction of the input forwarding pipeline.
- Extended embedded mirroring key forwarding to support a broader range of key types.
- Optimized preference interactions — device-dependent options are now automatically disabled in global configuration mode.
- Improved the empty state display of the device list.
- Added internationalization support for the automation script key list.
- Optimized the check-for-update popup window style.
- Improved error prompts within the embedded mirroring module.
- Optimized window arrangement function details for multi-device layouts.
- Improved the universal scrollbar interaction experience across the app.
♻️ Code Refactoring & Engineering Improvements
- Refactored and reconstructed the embedded mirroring module directory structure and overall architecture for better maintainability.
- Introduced a new parameter injection approach in the embedded mirroring module, resolving reactivity loss issues.
- Reconstructed the window aspect ratio algorithm for full cross-platform compatibility.
- Reconstructed the embedded mirroring keyboard module.
- Optimized and cleaned up the group control module naming conventions and directory layout.
- Removed redundant conditional checks and unused code from the embedded mirroring module.
- Expanded the embedded image switching capability and improved reusability of the window ratio logic.
v2.6.2
2.6.2 (2026-03-13)
This release introduces the full system capability of the Automation Script Editor, covering the entire workflow including visual script editing, multi-device batch execution, and scheduled task automation. In addition, device window layout adaptation has been significantly optimized, multiple known issues have been resolved, and overall product stability and user experience have been greatly improved.
🎉 Major New Features
- Optimized device window layout logic: by retrieving the actual device screen resolution and removing fixed-ratio scaling, black borders are completely eliminated, significantly improving display accuracy and screen adaptation.
- Added a batch automation script subscription solution.
- Added ready-to-use script templates specifically designed for WeChat scenarios.
- Completed internationalization support for the automation script module.
- Improved the overall interaction experience of automation scripts.
- Optimized the interaction logic of magic variables and added import/export capabilities.
- Introduced core capabilities for the automation script editor.
- Added core support for batch execution and scheduled task automation of scripts.
- Product-level refinement and feature completion of the automation script editor.
🐛 Bug Fixes
- Fixed issues related to custom startup layouts and interaction anomalies.
- Fixed logging issues caused by the automation script log directory being ignored.
- Fixed translation issues in script templates.
- Fixed compatibility issues with form variables after the automation script editor module split.
- Fixed incorrect task type display in the scheduled task list.
- Fixed screen lag and blocking issues during batch execution.
- Fixed an issue where the aspect ratio could not be locked when adjusting saved window layouts.
- Fixed an issue where window layout configurations could not be properly restored.
- Fixed concurrency issues with variable injection during batch script execution.
- Fixed an issue where automation scripts could not confirm interruption during execution switching.
- Optimized subscription configuration logic and related experience.
- Fixed test-related issues in the automation script editor.
⚡ Experience & Performance Improvements
- Improved the interaction experience of the smart picker feature.
- Added termination logic to the automation script selector and optimized related interactions.
- Added execution range selection in the script editor, allowing specific steps to be executed on demand.
- Various detailed UX improvements in the automation script editor.
- Significantly improved the stability of automation script execution.
- Integrated a universal hook capability for ADB keyboard installation.
- Continued optimization of script editor feature details.
- Improved interaction details in the automation script editor.
- Further refinement of the script editor interaction experience.
- Optimized details of core automation script functionality.
- Improved interaction details during automation script execution.
- Optimized the overall internationalization translation content.
- Product-level detail refinements and experience improvements.
- Optimized the startup installation logic of the ADB keyboard.
- Improved the layout and user experience of the scheduled task execution page.
- Removed the deprecated Shell script feature.
- Added support for synchronizing magic variables when importing templates.
- Retrieved device screen resolution when fetching the device list to further improve window layout adaptation.
- Enhanced runtime stability of the automation script editor.
- Continued optimization of the overall interaction experience of the script editor.
♻️ Code Refactoring & Engineering Improvements
- Restored system version-related configurations.
- Removed redundant debug logging.
- Completed the refactoring and modularization of the script editor form module.
- Extracted common logic for application launching and encapsulated it as a reusable selector.
- Optimized internal implementation details of the automation script editor.
- Refactored and optimized internationalization translations.
- Optimized interaction logic for the batch script execution selector.
- Improved the size and display experience of the delete confirmation dialog.
- Improved code standards and implementation details across the project.
- Added support for adjusting subscription pricing via environment variables.
- Integrated the script editor and expanded configuration capabilities.
- Optimized the overall project directory structure and naming conventions.