How race-engineering-center/ksana works
ksana is a Windows CLI for recording, replaying, and inspecting racing-simulator telemetry. Its main workflow detects a supported simulator, samples telemetry into compressed recording files, then replays those frames through simulator-compatible shared memory for downstream tools. The graph also shows inspection, simulator-specific adapters, and the shared-memory and file-format layers. Relationships for unsampled modules are included only where documented or named by the SOURCE INDEX; uncertain wiring is omitted.
Main entry points: record.rs Recording command · play.rs Playback command · connector.rs Assetto Corsa adapter · main.rs CLI dispatcher
Components 21
CLI workflows
- CLI dispatcher
src/main.rs - Recording command
src/commands/record.rs - Playback command
src/commands/play.rs - Inspect command
src/commands/inspect.rs
Recording and format
- Recording file
- Compressed frame format
src/io.rs
Simulator adapters
- iRacing connector
src/sims/iracing/connector.rs - iRacing frame data
src/sims/iracing/data.rs - iRacing player
src/sims/iracing/player.rs - AC connector
src/sims/ac/connector.rs - AC frame data
src/sims/ac/data.rs - Assetto Corsa adapter
src/sims/assettocorsa/connector.rs - Assetto Corsa data
src/sims/assettocorsa/data.rs - Assetto Corsa player
src/sims/assettocorsa/player.rs
Shared-memory runtime
- AC shared-memory I/O
src/sims/ac/shmio.rs - Windows shared memory
src/shm.rs - Adaptive timing
src/sleeper.rs
Other components
- Developer
- iRacing
- Assetto Corsa / ACC
- Telemetry consumer
Connections 31
- Developer → CLI dispatcher: runs
README.md - CLI dispatcher → Recording command: dispatches
src/main.rs - CLI dispatcher → Playback command: dispatches
src/main.rs - CLI dispatcher → Inspect command: dispatches
src/main.rs - Recording command → iRacing connector: probes
src/commands/record.rs - Recording command → Assetto Corsa adapter: probes
src/commands/record.rs - Recording command → Compressed frame format: saves frames
src/commands/record.rs - Recording command → Adaptive timing: paces sampling
src/commands/record.rs - Recording command → Recording file: writes
README.md - iRacing connector → iRacing frame data: uses format
src/sims/iracing/connector.rs - iRacing connector → Windows shared memory: reads
src/sims/iracing/connector.rs - iRacing → iRacing connector: exposes telemetry
README.md - Assetto Corsa adapter → AC connector: delegates
src/sims/assettocorsa/connector.rs - Assetto Corsa adapter → Assetto Corsa data: uses types
src/sims/assettocorsa/connector.rs - Assetto Corsa adapter → AC shared-memory I/O: uses
src/sims/assettocorsa/connector.rs - AC connector → AC frame data: uses types
src/sims/ac/connector.rs - AC connector → AC shared-memory I/O: reads pages
src/sims/ac/connector.rs - AC shared-memory I/O → Windows shared memory: maps pages
src/sims/ac/shmio.rs - Assetto Corsa / ACC → Assetto Corsa adapter: exposes telemetry
README.md - Playback command → Compressed frame format: loads frames
src/commands/play.rs - Playback command → iRacing player: selects by ID
src/commands/play.rs - Playback command → Assetto Corsa player: selects by ID
src/commands/play.rs - Playback command → Adaptive timing: paces playback
src/commands/play.rs - Playback command → Recording file: reads
README.md - iRacing player → iRacing frame data: decodes frames
src/sims/iracing/player.rs - iRacing player → Windows shared memory: writes telemetry
src/sims/iracing/player.rs - Assetto Corsa player → Assetto Corsa data: uses types
src/sims/assettocorsa/player.rs - Assetto Corsa player → AC shared-memory I/O: writes frames
src/sims/assettocorsa/player.rs - Telemetry consumer → Windows shared memory: reads telemetry
README.md - Inspect command → Compressed frame format: reads metadata
src/commands/inspect.rs - Inspect command → Recording file: reads
README.md