Architecture

Hub-Agent pattern with WebSocket as the primary communication channel.

Hub

Your PC

  • Discovers Agents via mDNS
  • Opens WebSocket connection
  • Sends files via TCP data channel (MD5 verified)
  • Stores auth tokens
  • Sends simple orders (Agent does the rest)
  • Receives telemetry & console log streams
  • Controls game log wrapper remotely

Agent

Target Device

  • WebSocket server (dynamic port)
  • Receives files with integrity verification
  • Creates Steam shortcuts
  • Applies artwork
  • Handles operations autonomously
  • Streams hardware telemetry (CPU, GPU, RAM, battery)
  • Console log & game log capture via CEF/CDP

Connection Flow

1

Agent broadcasts via mDNS

2

Hub connects via WebSocket

3

6-digit pairing code

4

Deploy games!

Transfer Architecture

CapyDeploy uses a dual-channel design for optimal performance and reliability.

WebSocket — Control Channel

  • Commands & responses
  • Real-time progress updates
  • Telemetry & console logs
  • Pairing & authentication

TCP — Data Channel

  • File transfers with streaming I/O
  • MD5 checksum verification
  • Transfer ACK confirmation
  • Bidirectional cancel support