Skip to content

Settings

星冉 edited this page Jul 24, 2026 · 3 revisions

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.
  • 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 diagnostic records that may include connection addresses; the service also receives the request IP. It never uploads screenshots or remote video. You can turn it off at any time, and re-enabling it requires confirmation.
  • 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.

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.

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.

Clone this wiki locally