SVappsLAB.iRacingTelemetrySDK 1.0.0-alpha.4

iRacing Telemetry SDK for C# .NET

High-performance .NET SDK for accessing live telemetry data from iRacing simulator and IBT file playback. Features compile-time code generation for strongly-typed telemetry access with lock-free performance optimizations.

Why Use This SDK?

• Live Telemetry: Real-time access to speed, RPM, tire data, and 200+ other variables during iRacing sessions
• IBT File Support: Full support for telemetry data saved in iRacing IBT files. Work with historical data using the same API as live telemetry
• Type Safety: Enum-based telemetry variables with IntelliSense/Copilot support and compile-time validation
• High Performance: Processes over half a million telemetry records/second with lock-free channel architecture
• Modern Async API: Real-time non-blocking channel-based data streams with async patterns and automatic backpressure handling

Perfect for building dashboards, data analysis tools, race engineering applications, and telemetry visualizations.

Installation

dotnet add package SVappsLAB.iRacingTelemetrySDK

Quick Start

using Microsoft.Extensions.Logging;
using SVappsLAB.iRacingTelemetrySDK;

// 1. Define the telemetry variables you want to track
[RequiredTelemetryVars([TelemetryVar.Speed, TelemetryVar.RPM])]
public class Program
{
    public static async Task Main(string[] args)
    {
        // 2. Create logger
        var logger = LoggerFactory.Create(builder => builder.AddConsole())
                                  .CreateLogger("Simple.Program");

        // 3. Choose data source
        IBTOptions? ibtOptions = null;  // null for live telemetry from iRacing
                                        // = new IBTOptions("gt3_spa.ibt");  // IBT file path for playback

        // 4. Create telemetry client
        await using var client = TelemetryClient<TelemetryData>.Create(logger, ibtOptions);
        using var cts = new CancellationTokenSource();

        // 5. Subscribe to telemetry data stream (60Hz rate)
        var telemetryTask = Task.Run(async () =>
        {
            await foreach (var data in client.TelemetryDataStream.ReadAllAsync(cts.Token))
            {
                Console.WriteLine($"Speed: {data.Speed}, RPM: {data.RPM}");
            }
        }, cts.Token);

        // 6. Subscribe to session info updates
        var sessionTask = Task.Run(async () =>
        {
            await foreach (var session in client.SessionDataStream.ReadAllAsync(cts.Token))
            {
                Console.WriteLine($"Track: {session.WeekendInfo.TrackName}, Drivers: {session.DriverInfo.Drivers.Count}");
            }
        }, cts.Token);

        // 7. Start monitoring
        var monitorTask = client.Monitor(cts.Token);
        await Task.WhenAny(monitorTask, telemetryTask, sessionTask);
    }
}

Requirements

• .NET 8.0+

Documentation & Examples

• Getting Started Guide - Quick setup and basic usage walkthrough
• Sample Projects - Ready-to-run examples: basic monitoring, data export, track analysis
• AI Usage Documentation - Comprehensive reference for AI coding assistants
• Migration Guide - Step-by-step migration from legacy events to modern channels
• GitHub Repository - Full source code and releases

License

Apache License 2.0 - See LICENSE for details.