How stclairc/tuxlink works
Tuxlink is a native Linux desktop client for Winlink emergency communications, combining strategic Winlink messaging with tactical APRS radio operations. Operators enter through the desktop workspace, configure a station, compose or select communications, and send them over CMS, HF, packet, or internet links; APRS also supports local position and chat. Other documented capabilities include forms, station discovery, search, offline maps, FT8 monitoring, WWV decoding, automation routines, and agent control behind operator consent. Source excerpts expose only selected wiring, so documented branches are included without asserting unsampled call relationships.
Main entry points: App.tsx App workspace · winlink_backend.rs Winlink B2F · mod.rs Radio links · engine.rs APRS engine
Components 23
Desktop workspace
- App workspace
src/App.tsx - Forms and composer
src-tauri/src/forms - Address book
src-tauri/src/contacts/store.rs
Radio communications
- Winlink mailbox
src-tauri/src/native_mailbox.rs - Winlink B2F
src-tauri/src/winlink_backend.rs - Radio links
src-tauri/src/winlink/mod.rs - APRS engine
src-tauri/src/winlink/aprs/engine.rs - AX.25 and UV-Pro
src-tauri/src/winlink/ax25/uvpro/session.rs
Station tools
- Station catalog
src-tauri/src/catalog/stations.rs - Station finder
src-tauri/src/station_query/engine.rs - Full-text search
src-tauri/src/search/query.rs - Offline maps
src-tauri/src/basemap/commands.rs - FT8 monitor
src-tauri/src/ft8/service.rs - WWV decoder
src-tauri/src/wwv_offair/commands.rs
Automation and agents
- Radio routines
src-tauri/tuxlink-routines/src/engine.rs - Consent gate
src-tauri/src/consent_gate.rs - Elmer assistant
src-tauri/src/elmer/commands.rs - MCP interface
src-tauri/tuxlink-mcp-core/src/router.rs
Application services
- Station configuration
src-tauri/src/config.rs
Other components
- Operator
- External MCP agent
- Winlink CMS
- Radio and TNC
Connections 23
- Operator → App workspace: operates
- App workspace → Winlink B2F: uses messaging
- Winlink B2F → Winlink mailbox: persists messages
- Winlink B2F → Winlink CMS: connects to
- Winlink B2F → Radio links: uses transports
- Radio links → Radio and TNC: drives
- App workspace → APRS engine: offers tactical chat
- APRS engine → AX.25 and UV-Pro: uses AX.25
src-tauri/src/winlink/aprs/engine.rs - AX.25 and UV-Pro → Radio and TNC: transmits frames
- App workspace → Forms and composer: composes forms
- App workspace → Address book: manages recipients
- App workspace → Station catalog: browses stations
- App workspace → Station finder: finds stations
- App workspace → Full-text search: searches messages
- App workspace → Offline maps: views offline maps
- App workspace → FT8 monitor: monitors FT8
- App workspace → WWV decoder: decodes WWV
- App workspace → Radio routines: runs routines
- Radio routines → Consent gate: requires consent
- App workspace → Elmer assistant: hosts assistant
- External MCP agent → MCP interface: issues tools
- MCP interface → Consent gate: gates operations
- App workspace → Station configuration: uses settings