How mk6i/open-oscar-server works
Open OSCAR Server is a Go instant-messaging server for classic AIM and ICQ clients. Its main workflow accepts client connections through OSCAR-compatible transports, dispatches protocol requests to handlers and domain services, and maintains user, session, buddy-list, and chat state. Separate front ends support TOC, ICQ’s legacy UDP protocol, and AIM’s Web API; an HTTP Management API administers users, sessions, and public chat rooms. The README documents additional messaging, presence, privacy, directory, and file-sharing capabilities. Edges reflect shown calls or README statements; unsampled subsystem links are omitted rather than inferred.
Main entry points: main.go Server process · feedbag.go Buddy lists · handler.go OSCAR handlers · server.go Legacy ICQ UDP
Components 23
Server entry and transports
- Server process
cmd/server/main.go - OSCAR transport
server/oscar/server.go - TOC transport
server/toc/server.go - Legacy ICQ UDP
server/icq_legacy/server.go
Protocol handling
- OSCAR handlers
server/oscar/handler.go - TOC commands
server/toc/cmd_client.go - Legacy ICQ service
server/icq_legacy/service.go - Wire protocol
wire/snacs.go
Messaging services
- Authentication
foodgroup/auth.go - Buddy lists
foodgroup/feedbag.go - ICQ services
foodgroup/icq.go - Session services
foodgroup/oservice.go
Runtime state
- User sessions
state/session.go - Session registry
state/session_manager.go - User accounts
state/user_store.go - Chat state
state/chat.go - Buddy-list state
state/feedbag_list.go
HTTP APIs
- AIM Web API
server/webapi/server.go - Web authentication
server/webapi/auth_handler.go - Web buddy lists
server/webapi/buddy_list_manager.go - Management API
server/http/mgmt_api.go
Other components
- AIM / ICQ clients
- Server administrators
Connections 24
- AIM / ICQ clients → OSCAR transport: connects
- AIM / ICQ clients → TOC transport: connects
- AIM / ICQ clients → Legacy ICQ UDP: connects
- Server process → OSCAR transport: starts
cmd/server/main.go - Server process → TOC transport: starts
cmd/server/main.go - Server process → Management API: starts
cmd/server/main.go - Server process → AIM Web API: starts
cmd/server/main.go - Server process → Legacy ICQ UDP: starts
cmd/server/main.go - OSCAR handlers → Buddy lists: calls
server/oscar/handler.go - OSCAR handlers → Authentication: calls
- TOC commands → Session services: calls
server/toc/cmd_client.go - TOC commands → Buddy lists: calls
server/toc/cmd_client.go - Web buddy lists → Buddy lists: queries
server/webapi/buddy_list_manager.go - Session services → User sessions: updates
- Session registry → User sessions: relays
state/session_manager.go - Server administrators → Management API: administers
- AIM / ICQ clients → AIM Web API: uses
- AIM Web API → Web authentication: routes
- Legacy ICQ UDP → Legacy ICQ service: dispatches
server/icq_legacy/server.go - AIM / ICQ clients → ICQ services: uses
- Wire protocol → OSCAR handlers: encodes frames
- User accounts → User sessions: supports
- Buddy lists → Buddy-list state: updates
- Chat state → Session registry: tracks participants