How toplcm/linkx works
LinkX is a Windows–Android companion app for nearby device pairing and cross-device productivity. Users discover a phone on the local network, pair over Bluetooth after comparing a six-digit code, then use Bluetooth for notifications, clipboard and media control, and an encrypted LAN channel for files and album transfers. The map includes both platform shells and shared session, security, transport and transfer layers. README statements support the shared-core and channel relationships; sampled excerpts and the source index provide additional wiring evidence, while unsampled feature internals are shown only at their documented subsystem level.
Main entry points: engine.rs Session engine · app.rs Windows app · LinkxRuntime.kt Android runtime · MainActivity.kt Android app
Components 22
Platform clients
- Windows app
Platforms/Windows/src/app.rs - Windows UI
Platforms/Windows/src/window.rs - Android app
Platforms/Android/app/src/main/java/com/linkx/app/MainActivity.kt - Android runtime
Platforms/Android/app/src/main/java/com/linkx/app/LinkxRuntime.kt - Windows shared state
Platforms/Windows/src/state.rs
Pairing and session
- Session engine
Crates/session/src/engine.rs
Transport
- Android BLE service
Platforms/Android/app/src/main/java/com/linkx/app/BlePeripheralService.kt - LAN discovery
Crates/lan/src/discovery.rs - LAN transport
Crates/lan/src/stream.rs - Windows BLE
Platforms/Windows/src/ble_central.rs
Security and protocol
- Device identity
Crates/crypto/src/identity.rs - Noise handshake
Crates/crypto/src/noise_resolver.rs - Frame encryption
Crates/crypto/src/cipher.rs - Replay protection
Crates/crypto/src/replay.rs - Message protocol
Crates/protocol/src/envelope.rs
Product features
- Notification sync
Platforms/Android/app/src/main/java/com/linkx/app/NlsService.kt - Android feature controls
Platforms/Android/app/src/main/java/com/linkx/app/Features.kt - Windows feature controls
Platforms/Windows/src/features.rs
File and album transfer
- Transfer tasks
Crates/transfer/src/task.rs - Chunk handling
Crates/transfer/src/chunk.rs - Local storage
Crates/storage/src/lib.rs
Other components
- User
Connections 26
- User → Windows UI: uses
README.md - User → Android app: uses
README.md - Windows UI → Windows app: commands
Platforms/Windows/src/window.rs - Windows app → Windows shared state: updates
Platforms/Windows/src/app.rs - Windows app → Windows BLE: drives BLE
Platforms/Windows/src/app.rs - Android app → Android runtime: starts
Platforms/Android/app/src/main/java/com/linkx/app/MainActivity.kt - Android app → Android BLE service: starts
Platforms/Android/app/src/main/java/com/linkx/app/MainActivity.kt - Android BLE service → Android runtime: initializes
Platforms/Android/app/src/main/java/com/linkx/app/BlePeripheralService.kt - Android BLE service → Session engine: relays BLE
Platforms/Android/app/src/main/java/com/linkx/app/BlePeripheralService.kt - Windows app → Session engine: drives session
Platforms/Windows/src/app.rs - Windows app → LAN discovery: discovers peers
README.md - Windows app → LAN transport: opens LAN channel
Platforms/Windows/src/app.rs - LAN discovery → LAN transport: locates peers
Crates/lan/src/stream.rs - Session engine → Message protocol: encodes messages
Crates/session/src/engine.rs - Session engine → Noise handshake: handshakes
Crates/session/src/engine.rs - Session engine → Frame encryption: encrypts frames
README.md - Session engine → Device identity: checks identity
Crates/session/src/engine.rs - Session engine → Replay protection: uses replay window
README.md - Session engine → Transfer tasks: routes file messages
Crates/session/src/engine.rs - Transfer tasks → Chunk handling: handles chunks
Crates/transfer/src/task.rs - Transfer tasks → Local storage: persists data
- Android runtime → Notification sync: forwards notifications
Platforms/Android/app/src/main/java/com/linkx/app/NlsService.kt - Android runtime → Android feature controls: checks features
Platforms/Android/app/src/main/java/com/linkx/app/LinkxRuntime.kt - Windows app → Windows feature controls: checks features
Platforms/Windows/src/app.rs - Windows app → LAN transport: transfers files
README.md - Android runtime → Session engine: calls native core
Platforms/Android/app/src/main/java/com/linkx/app/LinkxRuntime.kt