Skip to content

Scrcpy GUI 2.4.0

Choose a tag to compare

@github-actions github-actions released this 15 Aug 14:40
· 55 commits to master since this release
cd4480d

Scrcpy GUI 2.4.0

The first stable release of the rebuilt Scrcpy GUI. It completes the M0-M4 software roadmap on top of the official, unmodified scrcpy 4.1 runtime.

这是重构版 Scrcpy GUI 的首个正式稳定版本:完成 M0-M4 软件路线,并继续使用未经修改的官方 scrcpy 4.1。

Highlights

  • Six validated scrcpy scenes: Screen, Camera, Virtual display, Record-only, Control-only, and separate no-ADB OTG
  • Per-device encoder, display, camera, size, FPS, facing, and zoom probes
  • Device workspace for details, applications, file push, APK install, screenshots, and artifact history
  • Named profiles with reviewed import/export and per-device assignment
  • Device groups with default profiles and explicit concurrency limits
  • Per-device batch preflight for launch, screenshot, app start, control, file push, APK install, and Automation V2
  • Bounded normalized tap/swipe/text/app/screenshot/control automation, cancellation, confirmation gates, and persisted partial run reports
  • Atomic Config V3 migration, structured sessions/events/errors, redacted diagnostic ZIPs, and a local issue helper

Downloads

  • macOS: Apple Silicon and Intel DMG/ZIP
  • Windows: x64 and ia32 installer/ZIP, plus combined installer and Chocolatey .nupkg
  • Linux x64: AppImage, Debian, Arch/Pacman, and portable tarball

Download SHA256SUMS.txt with the desired files and verify it before opening an unsigned package, for example: shasum -a 256 -c SHA256SUMS.txt.

Release evidence

  • 19 test files / 174 tests
  • Windows, macOS, and Linux test/build jobs passed
  • Each packaging host extracted its current-architecture final archive and executed packaged scrcpy --version (4.1) and adb version (1.0.41)
  • 15 uploaded assets; all 14 package digests were matched against SHA256SUMS.txt and GitHub server digests
  • Responsive rendering checked at 880x640, 1120x780, 1440x900, and DPR 2 without page-level horizontal overflow
  • Published-asset install → upgrade → installed Renderer startup → runtime → uninstall lifecycle passed on macOS DMG, Windows NSIS, and Ubuntu Debian paths: https://github.com/SimonAKing/scrcpy-gui/actions/runs/31892938302

Full evidence: v2.4.0 release smoke report.

Explicit verification gaps

  • Packages are not code-signed or notarized.
  • No physical Android device was attached during this release run. Physical screen/audio/record/multi-device, pairing/mDNS, Camera, Virtual display, V4L2, Control-only, and OTG hardware paths are therefore not claimed as release-tested.
  • Manual interactive installer UX was not separately reviewed on every host OS; the automated hosted-runner install/upgrade/uninstall lifecycle passed on all three representative native installer paths.
  • CHOCO_API_KEY is not configured. The verified .nupkg is attached here, but Chocolatey Community publication/review is still open.

These are disclosed evidence gaps, not inferred failures or fabricated support claims.

Key pull requests

#159 · #167 · #174 · #179 · #181 · #184 · #185 · #186 · #187 · #188