Skip to main content

The Browser Interface

Waylo's entire client is the web page it serves — there is nothing else to install. This page covers the login screen and the in-session toolbar. (The optional desktop app wraps this same page in saved connections and session tabs, so everything here applies there too.)

Login screen​

The login screen collects your host credentials and your per-session preferences:

  • Username / password — the host desktop user's Linux login (verified over SSH; see Security).
  • Frame rate and Quality — tune for your link; see Performance.
  • Set up unattended access — configures GDM auto-login and installs the locked-screen extension on this login; see Unattended Access.
  • Additional toggles (fullscreen on connect, auto-capture pointer, multi-monitor, reduced effects, lock on disconnect).

Your choices are remembered in the browser and pre-filled next time.

The toolbar​

Once connected, a toolbar slides down from the top-center of the window (hover the top edge, or click the nub). It provides:

  • Monitor switcher — choose which monitor to view, or pop one out into its own window (see Input & Monitors).
  • Scaled / natural size — scaled (the default) draws the remote screen as large as the window allows; natural keeps it at 1:1 pixels, sharper on a remote screen smaller than your window at the cost of a black surround. Either way the aspect ratio is kept, and a screen bigger than the window is shrunk to fit. The choice is remembered for next time.
  • Fullscreen — expand the video to fill the browser/display.
  • Audio mute — silence the desktop audio stream (also stops decoding to save CPU).
  • Lock screen — lock the remote session without disconnecting; you can type the password remotely to unlock.
  • Settings row (⚙️) — change frame rate and quality mid-session. The change applies immediately to every connected client and is remembered for next time.
  • Disconnect — end the session.

Reconnect behavior​

If the network drops or the server restarts, the client keeps the last frame on screen and automatically reconnects, re-authenticating with the stored session credentials and resuming the same monitor view. A server restart that briefly tears down the backend is bridged the same way — you generally don't need to log in again.

Pointer capture​

Click the video to capture the pointer; press Esc or Ctrl+M to release it. Keyboard and scroll input are only forwarded while the pointer is captured. See Input & Monitors for the full input model.