Changelogs
Complete Rebuild
- From Scratch: Rebuilt entire codebase from zero as a clean project, not an incremental refactor of v1.x.
- New Architecture: Domain-package backend (
internal/<domain>/) with clean separation between Wails binding layer and business logic. - React 19 + TypeScript 6: Modern frontend stack with strict type safety, React Compiler, and Vite 8.
- Bun Runtime: Frontend package management and scripts now use Bun instead of npm/yarn.
Setup Wizard & Binary Lifecycle
- First-Run Wizard: Guided 4-step setup (Welcome → Platform Tools → scrcpy → Summary) with auto-detection, manual selection, or one-click download.
- Managed Binary Download: Downloads full release packages (not standalone executables) — preserves
lib64/,scrcpy-server, and all supporting files. - Binary Detection Cascade: Config path → System PATH → Managed package → Common OS locations.
- Custom Path Support: File picker or folder picker for any binary (ADB, Fastboot, scrcpy).
- Cross-Platform Lookup: Windows, macOS, and Linux candidate paths with runtime revalidation.
Scrcpy Hub (Core Feature)
- Native Window Mirroring: Screen mirror runs in its own native window, not embedded in the app.
- Headless Recording: Record screen with timer, file size estimate, and format selection.
- Screenshot Capture: Capture, preview, and save screenshots via ADB.
- Clipboard Sync: Push/pull clipboard between host and device.
- Encoder Detection: Auto-detect available video/audio codecs with hardware acceleration priority.
- Preset Management: Save and switch between quality/resolution/codec presets.
- Process Monitoring: Detect when scrcpy is closed externally and sync state to UI.
Flasher & Fastboot
- Flash Plan: Auto-scan ROM folder for
.imgfiles, map to partitions, and flash in priority order. - Partition Flashing: Flash single partition with validation against 22 known partition names.
- A/B Slot Management: Get/set active slot with visual feedback.
- Sideload: Flash ZIP packages via ADB sideload.
- Wipe Data: Destructive operation with confirmation guardrail.
- Custom Fastboot Commands: Input with shell operator blocking (
&|;><$` sanitization).
App Manager
- Virtualized List: Handle thousands of packages smoothly via TanStack Virtual.
- Batch Operations: Uninstall, enable, or disable multiple apps with confirmation dialogs.
- APK Management: Install via file picker or drag-and-drop, pull installed APKs to host.
- Package Details: View version, APK size, data size per package.
File Explorer
- Virtualized File List: Smooth browsing even in large directories.
- Transfer Engine: Push/pull with streaming progress, retry logic (3 attempts for transient ADB errors), and cancellation support.
- Batch Transfers: Multi-file push/pull with partial failure reporting.
- Protected Paths: Write operations blocked to 20+ system directories (
/system,/data,/vendor, etc.).
Terminal & Logcat
- Multi-Mode Terminal: ADB Shell, ADB Host, and Fastboot Host modes.
- Command History: Re-execute previous commands from history.
- Real-Time Logcat: Streaming with 100ms batched ingestion for high-throughput logs.
- Log Filtering: Filter by level, tag, and text with keyboard shortcuts.
- Export: Save logcat output to file.
Dashboard & Device Manager
- Live Performance Monitor: CPU, RAM, network RX/TX with sparkline charts (3s polling).
- Device Selector: Switch between multiple connected devices.
- Device Info: Full specs (model, codename, Android version, security patch, battery, storage).
- Reboot Actions: System, Recovery, Bootloader, Fastboot.
- Wireless ADB: Connect/disconnect via IP:port with TCP/IP mode enable.
UI & Design
- Apple/macOS-Like Design: systemBlue accent, cool-gray neutral, soft shadows, material/vibrancy on floating surfaces.
- Floating Dock: macOS-style bottom dock with magnetic hover, spring indicator, and auto-hide.
- Dark & Light Mode: Full OKLCH token coverage for both themes.
- Reduced Motion: Respects
prefers-reduced-motion— all animations zeroed out. - Command Palette: Ctrl+K for quick navigation, device refresh, screenshot, theme toggle.
- Toast Notifications: Sonner with accent bar per status, monospace technical details.
Security
- No Shell Injection: All command execution uses array-based args, never shell interpolation.
- Path Traversal Protection: 3-layer defense for remote file operations.
- Protected System Paths: Write operations blocked to sensitive device directories.
- Audit Logging: Structured operation logging with path redaction (1000-entry cap).
Architecture
- Service Boundary: Zero Wails binding imports in React components — all calls go through service layer.
- State Separation: Zustand for UI state, React Query for server-state (settings/audit logs).
- Error Model: Structured
OperationErrorwith user-facing message, technical detail, and retryability flag. - Platform-Specific Code: Build-tagged files for Windows, Linux, and macOS execution handling.
Packaging (Linux-First)
- deb, rpm, Arch Linux, AppImage: Full packaging support via Makefile.
- nfpm Integration: Automated deb/rpm builds with version templating.
- AppImage: Self-contained binary with desktop integration.
Note: This is a Linux-first beta release. Windows and macOS support is designed in the backend (cross-platform lookup paths, platform-specific execution) but requires final QA before full release.