Settings

Settings

中文

Settings contains app-wide preferences and maintenance tools. Session-specific options such as bitrate, game mode, audio, and the floating ball remain in the session editor.

General

• Appearance: choose the app theme and related visual preferences.
• Group Management: create multi-level groups and organize saved sessions.
• Custom Commands: define quick shell commands used by the command section in management mode. You can add, rename, reorder, and delete entries, and choose whether they replace the built-in quick command list.
• Backup & Restore: export settings, sessions, groups, pairing metadata, and ADB keys to JSON, or import a backup. Import replaces the current data, so export a fresh backup first.
• Floating Ball Haptic Feedback: controls vibration for floating-ball gestures and buttons; it does not show or hide the ball.
• Allow Screen Capture: allow screenshot and screen recording for the app window. When off, the app applies FLAG_SECURE to block both.
• Show FPS & Network Rates: shows decoded/rendered FPS, video bitrate, and app network transmit/receive rates during scrcpy sessions. It is off by default and takes effect without reconnecting.
• Language: follow the system language, use Chinese, or use English.
• About: view version, project, support information, update controls, and telemetry diagnostics.
• Telemetry Diagnostics: sends one ping on every app startup when enabled and uploads the previous day's logs if not already uploaded. Use the upload action on the About page to immediately send today's and yesterday's logs. The service receives the request IP and may store connection addresses in logs; it never uploads screenshots or remote video. You can turn it off at any time, and re-enabling it requires confirmation.

ADB management

• Manage ADB Keys: inspect or delete authentication key pairs. If a device remains unauthorized, remove the stale key and reconnect so the target can request authorization again.
• Device Pairing: pair through Wireless Debugging with the target IP, pairing port, and pairing code shown by Android.
• Local Wireless Debugging (Local ADB): configure and maintain a local ADB loopback environment on the host Android device.
  • Developer Options & USB Debugging: independent switches to toggle system DEVELOPMENT_SETTINGS_ENABLED and ADB_ENABLED without cross-coupling (enabling wireless debugging never silently forces USB debugging on).
  • Local Port Configuration & Probing: configurable fixed port (default 5555) with fast reflection probing of service.adb.tls.port (Android 11+) and service.adb.tcp.port, verified via loopback socket.
  • Listen to Wi-Fi State: dynamically monitors Wi-Fi connection changes via ConnectivityManager.NetworkCallback and automatically reapplies local ADB configuration upon network roams.
  • Disable USB Auth Timeout: sets adb_allowed_connection_time to 0 to prevent authorization timeout expiration.
  • Desired State Configuration: persists user intent across app launches and network changes, ensuring declared settings are automatically aligned.
  • Boot-Up Auto-Start (BootCompletedReceiver): listens for system BOOT_COMPLETED and automatically restores desired ADB states upon device reboot without requiring manual app launch.
  • Real-Time Verification & Rollback: toggles execute immediate preflight/postflight checks; if underlying permissions are missing or system writes fail, switches immediately spring back to false with explicit feedback.
  • Root & Advanced Helpers: provides Root command assistance (setprop service.adb.tcp.port && stop/start adbd) for fixing ports, alongside privileged shell grants for WRITE_SECURE_SETTINGS and Android 13+ ACCESS_RESTRICTED_SETTINGS.
  • Accessibility Auto-Authorization Service (AdbAuthAccessibilityService): optional background accessibility service that automatically detects and confirms ADB authorization dialogs across AOSP, MIUI/HyperOS, ColorOS, OriginOS, EMUI/HarmonyOS, and OneUI, protected by a strict time-limited lease token (grantAuthPermit).

Logs

• Debug Mode: shows a live-log button at the bottom-right of app screens.
• Enable Activity Log: master switch for persistent activity logging.
• Event, audio, video, control, shell, and management detail switches are for focused troubleshooting and are available only when activity logging is enabled.
• Log Management: view, export, or delete individual log files.
• Clear Logs: removes current app logs.

Detailed stream logging can be noisy. Enable only the category needed to reproduce a problem, then turn it off after collecting the evidence.

Feedback and help

• Submit Issue opens the project issue tracker.
• User Guide opens this Wiki, whose default landing page is English; use each page's Chinese link when needed.

Settings related to remote control

The global haptic and performance-statistics switches apply independently of game mode. The session's floating-ball switch decides whether the controller appears, while the global haptic switch only changes feedback.