README.md

lamco-rdp-tools documentation

Documentation for the rdpsee (observe) and rdpdo (act) RDP tools, organized by the Diátaxis framework: tutorials to learn, how-to guides to get a task done, reference for the facts, and explanation for the ideas.

Tutorial — start here

• Getting started — your first inspection and automation, end to end.

How-to guides — task-oriented

Observe (rdpsee):

• Scan a subnet for RDP exposure and gate it in CI
• Fingerprint and inventory a server fleet
• Inspect a server's TLS certificate
• Capture recon screenshots

Act (rdpdo):

• Automate a login and reach the desktop
• Run a visual-regression check in CI
• Record and replay a session
• Calibrate click coordinates
• Verify audio playback
• Provision a fresh VM

Use cases — scenario-oriented

• CI/CD visual testing
• Golden-image validation
• Security recon and RDP-exposure audit
• VDI performance baselining
• Accessibility verification
• Server fleet inventory

Explanation — concepts

• Observe vs act: the two tools
• The connection and security model
• Visual matching and needles
• The rdpsee fingerprint scheme
• Codecs and graphics

Reference — the facts

• Command reference: man rdpsee, man rdpdo, or <tool> help [command]
• JSON output — the --json shapes each command emits
• Exit codes

---

For an overview of the toolkit and installation, see the top-level README. Both tools work against any standards-compliant RDP server. Website: https://lamco.ai/products/lamco-rdp-tools/.