Skip to content
星冉 edited this page Aug 3, 2026 · 2 revisions

Screen Remote for macOS

中文

Screen Remote for macOS is the native SwiftUI companion for controlling and managing Android devices from macOS. This Wiki is the canonical bilingual entry point for macOS usage, architecture, and maintenance notes.

Current product boundary

  • Device discovery, persistent device groups, ADB-backed apps, files, processes, port forwarding, device information, tooling, virtual devices, settings, diagnostics, and multi-screen UI are present in the app.
  • The primary screen session uses the app-owned native scrcpy 4.1 path: official server, ordered sockets, H264/H265 decoding through VideoToolbox, and a SwiftUI surface.
  • OPUS, AAC, and FLAC audio can be decoded through Core Audio, with RAW fallback and playback. Pointer touch messages are routed through the control socket; the remaining control-message families are still incomplete.
  • Notifications, Messages, and Photos are UI/empty-state surfaces only; they need a companion-side or protocol-backed data channel before they become functional.

Product terminology

  • Small Window (小窗): a screen session displayed inside the Screens workspace.
  • Large Window (大窗): the same screen session after it is expanded from Screens.
  • Auxiliary Menu (辅助菜单): the transient controls and session actions shown around a Small Window or Large Window.

Use these names consistently in product and user-facing documentation. Terms such as embedded, detached, independent window, window chrome, toolbar, or control bar should appear only when a specific implementation detail requires them.

Reading paths

Documentation rule

Every maintained English page has a complete Simplified Chinese counterpart with the same headings and facts. Use current source, Xcode configuration, and the repository AGENTS.md as the technical source of truth. Do not present a target architecture or a planned protocol feature as implemented.

Clone this wiki locally