How alhanshim/socketchat works
SocketChat is a terminal LAN messenger: users choose automatic discovery or enter a peer IP, establish a connection, and exchange per-chat encrypted messages. A background listener can notify the user of incoming connection requests, which they may accept or ignore. The graph separates the UI and orchestration, discovery and connection stages, and chat transport/security. Some implementation details are unsampled; edges rely on the README or the cited excerpts and SOURCE INDEX references.
Main entry points: window.py App coordinator · welcome_page.py Welcome screen · functions.py Socket transport · startup.py Discovery protocol
Components 15
Terminal interface
- CLI entry
socketchat/commands.py - Welcome screen
socketchat/tui/welcome_page.py - Auto-connect screen
socketchat/tui/auto_loading.py - IP-connect screen
socketchat/tui/ip_loading.py - Loading indicator
socketchat/tui/loading.py - Chat screen
socketchat/tui/chat.py
Session coordination
- App coordinator
socketchat/window.py - Command parser
socketchat/core.py
LAN connection
- Background listener
socketchat/core.py - Discovery protocol
socketchat/startup.py - Direct connector
socketchat/connecting.py
Chat transport
- Socket transport
socketchat/functions.py - Message encryption
socketchat/functions.py
Other components
- User
- LAN peer
Connections 24
- User → CLI entry: starts
README.md - CLI entry → App coordinator: runs
socketchat/commands.py - App coordinator → Welcome screen: shows
socketchat/window.py - User → Welcome screen: chooses mode
README.md - Welcome screen → Command parser: parses command
socketchat/tui/welcome_page.py - Welcome screen → Auto-connect screen: opens auto mode
socketchat/tui/welcome_page.py - Welcome screen → IP-connect screen: opens IP mode
socketchat/tui/welcome_page.py - App coordinator → Background listener: starts listener
socketchat/window.py - Background listener → Discovery protocol: runs listener
socketchat/core.py - Discovery protocol → LAN peer: broadcasts packets
README.md - LAN peer → Discovery protocol: replies by UDP
README.md - Auto-connect screen → Discovery protocol: starts discovery
socketchat/tui/auto_loading.py - Auto-connect screen → App coordinator: opens chat
socketchat/tui/auto_loading.py - IP-connect screen → Loading indicator: renders
socketchat/tui/ip_loading.py - IP-connect screen → Direct connector: starts connection
socketchat/tui/ip_loading.py - Direct connector → Discovery protocol: sends unicast
socketchat/connecting.py - Direct connector → App coordinator: starts server
socketchat/connecting.py - LAN peer → Direct connector: connects by TCP
README.md - IP-connect screen → Chat screen: opens on connect
socketchat/tui/ip_loading.py - App coordinator → Socket transport: starts socket route
socketchat/window.py - Chat screen → Socket transport: queues messages
socketchat/tui/chat.py - Socket transport → Message encryption: encrypts messages
README.md - Socket transport → Chat screen: delivers received text
socketchat/functions.py - LAN peer → Socket transport: exchanges messages
README.md