Skip to content

v2.0.0-beta1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@Drenzzz Drenzzz released this 04 Jul 18:28
v2.0.0-beta1
0a91394
This commit was signed with the committer’s verified signature.
Drenzzz Drenzzz.
GPG key ID: 9E2C83F2B3664D7D
Verified
Learn about vigilant mode.

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 .img files, 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 OperationError with 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.

Assets 6
Loading