remcat

LAN remote desktop with SSH control, UDP media streaming, and a localhost controller.

pip install remcat

Components

• remcatd — Daemon that runs on the target machine. Captures screen, injects mouse/keyboard, provides a windowless shell, and exposes system actions (lock/shutdown/reboot/sleep).
• remcat — Client CLI and GUI desktop viewer.

Quick start

# Start the daemon on the remote machine
remcatd

# On your local machine, discover daemons on the LAN
remcat discover

# Connect with the desktop viewer
remcat connect 192.168.1.100:2222

# Open a remote shell
remcat shell 192.168.1.100

# Send a controller command to the local daemon
remcat controller status
remcat controller action lock
remcat controller set-accept-level ask_new

Architecture

Daemon settings (~/.remcat/daemon.json)

• node_name — Hostname broadcast on the LAN
• ssh_port / udp_port / controller_port — Port mappings
• accept_level — auto | ask_new | ask_all
• known_devices — Per-fingerprint trust settings
• capture_fps — Screen capture framerate (default 15)
• jpeg_quality — JPEG encode quality (default 75)
• actions_enabled — Allow lock/shutdown/reboot/sleep

Controller (localhost, no web)

The daemon exposes a localhost-only socket on port 2225. Send JSON commands to script the daemon:

echo '{"cmd":"status"}' | nc 127.0.0.1 2225

License

MIT