Skip to content

Session Management

星冉 edited this page Jul 21, 2026 · 1 revision

Session Management

中文

A session is the basic unit in Screen Remote. It describes one device connection, display parameters, and selected runtime options.

Session contents

  • Name.
  • Device type: TCP, USB, or mDNS.
  • Host, USB serial, or mDNS service name.
  • Port, entered manually only for TCP.
  • Resolution, bitrate, and frame rate.
  • Audio, screen-off, stay-awake, and related options.
  • Display settings such as full-screen mode.

Common operations

  • Create, edit, copy, or delete a session.
  • Open remote control from a session.
  • Open the management pages from a session.

Session-list states

The list reflects the real state: USB or Wi-Fi transport, remote control active, ADB connected, connecting, or disconnected. Entering management and establishing ADB should show “ADB connected” even without remote video.

Device types and input

  • TCP: enter an IP/host and port.
  • USB: enter a USB serial or select a scanned device.
  • mDNS: enter an _adb-tls-connect._tcp service or select a nearby Wireless Debugging device.

The app converts these values to usb:<serial>, tcp:<host>:<port>, or mdns:<service> internally. Users do not add these prefixes. USB, TCP, and mDNS are separate transports and are not automatically assumed to represent the same physical device.

Recommended organization

  • Keep one base session per device.
  • Copy sessions when different bitrates or display modes are useful.
  • Keep USB and Wireless Debugging sessions separate for easier troubleshooting.
  • Save USB, TCP, and mDNS as separate sessions even for the same physical device.

Common options

  • turnScreenOff: turns off the target display during remote control.
  • Audio: enable only when needed.
  • Full-screen mode: use for true full screen or stronger background retention.

Game mode

Game mode uses constrained presets intended for responsive interaction. Video bitrate choices are 1M, 2M, 4M, 8M, 12M, and 20M; an empty or below-range value becomes 2M. Size and frame rate are normalized to their game-mode presets as well, and full-screen mode is disabled.

The floating ball and Show FPS & Network Rates remain available in game mode. They are controlled independently by the session option and Settings, respectively.

About full-screen mode

Full-screen mode uses TextureView and may add slightly more latency than the normal SurfaceView mode.

When to use management only

Use management without remote video to run ADB commands, inspect device information, or manage apps and files.

Clone this wiki locally