v2.4.1

# [2.4.1](https://github.com/viarotel-org/escrcpy/compare/v2.3.1...v2.4.1) (2026-02-26)

This release consolidates major architectural upgrades, a fully redesigned terminal system, wireless connectivity improvements, Fastboot support, and extensive stability fixes.

---

## ✨ Features

### Fastboot Support

* Added Fastboot command support.
* Experimental integration of scrcpy dependencies for Linux ARM64 platforms.

### Built-in Terminal System (xterm-based)

* Fully migrated to an embedded terminal powered by xterm.
* Added interactive shell support.
* Improved terminal styling and scrollbar appearance.
* Enhanced resize handling, rendering stability, and cursor synchronization.
* Implemented terminal session retention and lifecycle management.
* Unified shell error handling and lazy-loading logic.
* Prioritized `pwsh.exe` on Windows.
* Filtered ANSI color codes for Windows PowerShell.
* Standardized UTF-8 encoding (removed Windows-specific encoding logic).
* Terminal title now supports dynamic i18n updates.

### Wireless Connectivity Enhancements

* Added wireless connection mode toggle.
* Improved wireless pairing flow and UI.
* Added pairing success notifications.
* Simplified wireless connection interface.

### File & Device Management

* Added drag-and-drop file upload support.
* Improved download and upload progress tracking (throttled callbacks).
* Optimized device query and control window behavior.
* Enhanced ADB keyboard installation and detection.
* Improved ADB keyboard error handling.
* Updated API endpoints and enabled ADB keyboard by default.
* Added macOS gnirehtet path support.

### Window Management Improvements

* Support manual window position and size configuration.
* Improved window bounds persistence logic.
* Optimized tray and minimized window handling.
* Replaced native window controls with application header controls.
* Exposed `$platform` to global and window contexts.
* Improved control bar height consistency.

### UI & UX Enhancements

* Added “Scroll to Bottom” button in chat.
* Updated primary theme color.
* Improved scrollbar styling with Tailwind CSS.
* Updated terminal tip color to custom RGB.
* Trigger language change callback immediately on initialization.

---

## 🐛 Bug Fixes

### Portable & Initialization

* Fixed language detection issue in portable builds.
* Reorganized initialization order to load store before processing configuration.

### Windows Terminal Stability

* Resolved Windows binary execution issues related to process termination.
* Unified Windows line-ending handling across scenarios.
* Fixed terminal encoding inconsistencies.
* Improved PowerShell compatibility.
* Fixed cursor sync and resize instability.
* Improved shell detection logic.
* Fixed dynamic terminal title language updates.
* Improved terminal exit and error state recovery.

### Internationalization

* Fixed i18n race conditions.
* Resolved missing and incorrect translation keys.
* Updated terminal locale strings.

### General Fixes

* Fixed clipboard tag type handling.
* Fixed preview button visibility issues.
* Corrected device payload handling and control bar height logic.
* Improved process termination error handling.
* Cleaned up redundant debug logs and legacy code paths.

---

## 🚀 Performance Improvements

* Optimized ADB keyboard installation and detection workflow.
* Improved process termination efficiency.
* Optimized minimized tray behavior.
* Reduced redundant progress update calls during file transfers.

---

## 🏗 Architectural Refactoring

This version includes a major Electron architecture overhaul.

### Electron Main Process Reconstruction

* Rebuilt main process architecture.
* Migrated to a modular service system based on explicit `app.use`.
* Introduced priority-based plugin registration.
* Standardized official plugin structure.
* Migrated IPC handling to ipcx.
* Centralized PATH setup and environment configuration.

### Module & Directory Restructuring

* Reconstructed multi-entry directory structure.
* Refactored core helpers, window management, and terminal modules.
* Restructured process helpers and Electron utilities.
* Migrated services and modules into plugin-based architecture.
* Reorganized copilot and explorer modules.

### Terminal System Refactor

* Extracted terminal logic into a dedicated `useTerminal` hook.
* Implemented provider-based terminal session management.
* Unified shell execution through a dedicated helper.
* Standardized terminal lifecycle and cleanup handlers.

### Dependency & Build Adjustments

* Integrated node-pty into Electron build.
* Replaced args-tokenizer with shell-quote.
* Replaced legacy packaging flags with `import.meta.env.MODE`.
* Migrated to electron-setup package.
* Moved i18next-fs-backend to production dependencies.

### Codebase Cleanup & Standardization

* Removed deprecated modules and legacy middleware.
* Removed Windows-specific encoding defaults.
* Unified module export patterns.
* Simplified window types and returned native BrowserWindow.
* Cleaned up unused styles, logs, and redundant configuration.
* Standardized control bar configuration.
* Reorganized process helper directory structure.