remcat 0.1.0

LAN remote desktop daemon and client with SSH control, UDP media, and localhost controller

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

Transport	Purpose	Port
SSH	Control commands, shell, auth	2222
UDP	Screen frames, mouse/keyboard input	2223
UDP	LAN discovery beacon	2224
TCP	Localhost controller (loopback only)	2225

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