01 / REMOTE CONTROL · PREVIEW
Your desktop.
A little closer.
Open the desktop of an enrolled device in your browser. Choose view-only access or keyboard and pointer control when local permissions allow it.
Prepare your computer
macOS
Connect the Caterm Mac app, then open its Permissions page. Enable screen access to view the display, and input access to control it. The Mac app provides session status and a disconnect action.
Linux
Linux shares an existing local X11 desktop. Run caterm desktop doctor from its terminal and resolve the reported prerequisites yourself before enabling sharing with caterm connect --desktop. This checks prerequisites and exits without connecting if they are not satisfied. Run the daemon and desktop as the same ordinary user.
Follow the complete Linux desktop sharing guide → to run doctor, install missing X11 dependencies, and prepare a desktop on a normal computer or headless VPS.
Start a browser session
- Open Devices, select an online device, and choose Desktop.
- Select a display and choose View or Control before connecting.
- Connect, then focus the display to send keyboard and pointer input.
- Use Disconnect to end the session. Escape releases pointer lock.
The viewer supports punctuation and local input methods, including Chinese composition. Focus the remote screen and use Paste to insert local plain text, or Copy/Cut to copy remote text back to your browser. The clipboard buttons offer explicit actions and selectable text if browser clipboard access is blocked. Clipboard reads are limited to about 4 KB; Linux text insertion is limited to 256 characters per action. Clipboard access requires a live Control session and only occurs on demand. Update Caterm on the device to enable remote clipboard reads. The viewer also offers picture settings and explicit text insertion. Disconnecting Linux desktop sharing leaves the local desktop and its applications running. Picture settings change the stream size without changing the local display resolution.
Connection and availability
The daemon connects outward to Caterm. Desktop signaling goes through the authenticated API; screen video and input use WebRTC, with a TURN relay when configured and needed.
Remote desktop requires platform support, local permissions, and a working direct or relay network path. Full end-to-end desktop validation and release packaging are still in progress. Device conversations and terminals do not require the optional Linux desktop.