How hdb-studio/tcp-api works
This repository is a LAN client/server messaging tool, with GUI client and server variants across version directories. The main workflow is to inspect network details, find a server, connect over TCP, and exchange messages; server variants also support UDP discovery, and newer sampled servers add optional TLS and compression. The README describes LAN use and an unstable beta. Sampled client/server protocol behavior differs, so the graph shows the connection and message transfer without implying compatible encoding. The API command branch is included based on its source.
Main entry points: Client.py GUI Client · sever.py TCP Server · offr.py Command Server · off,r Power Actions
Components 12
Client
- GUI Client
TCP V2.0.0 Beta version/Client.py - Network Info
TCP V2.0.0 Beta version/Client.py - LAN Scan
TCP V2.0.0 Beta version/Client.py - TCP Client
TCP V2.0.0 Beta version/Client.py
Server
- TCP Server
TCP V2.1.0 Beta version/sever.py - Client Handler
TCP V2.1.0 Beta version/sever.py - UDP Discovery
TCP V2.1.0 Beta version/sever.py - TLS Option
TCP V2.1.0 Beta version/sever.py
Remote Commands
- Command Server
TCP V1.0.0/API/off,r/offr.py - Power Actions
TCP V1.0.0/API/off,r
Other components
- User
- LAN Peer
Connections 14
- User → GUI Client: uses
- GUI Client → Network Info: reads details
- GUI Client → LAN Scan: starts scan
- LAN Scan → LAN Peer: probes TCP
- GUI Client → TCP Client: connects and sends
- TCP Client → TCP Server: TCP messages
- TCP Server → TLS Option: optionally wraps
- TCP Server → Client Handler: dispatches client
- Client Handler → TCP Client: sends response
- TCP Server → UDP Discovery: starts listener
- LAN Peer → UDP Discovery: UDP query
- UDP Discovery → LAN Peer: UDP response
- LAN Peer → Command Server: sends command
- Command Server → Power Actions: runs batch files