SDK Data

The SDK gives access to data (Session Data, Live Telemetry Data and Broadcast Messages) from the iRacing Simulator while it is running. Some variables are sent to the telemetry disk and others are available live. Not all cars provide all variables and in replays data is significantly limited.

Developing with the SDK,

If you are interested in developing your own application you visit the iRacing SDK Forum.= to get started. There are many plugins available in different languages. iRaceEngineer uses the brilliant Python PYIRSDK Wrapper.

These update at every tick of the simulator but not all are always live. Whether they are available depends on how the sim is running e.g Test Drive, Replay or an Official, Hosted session. Some of the variables are passed to disk and others are outputted live. Not all cars provide all the data.

Label Description Unit
SessionTimeSeconds since session starts
SessionTickCurrent update number
SessionNumSession number
SessionStateSession stateirsdk_SessionState
SessionUniqueIDSession ID
SessionFlagsSession flagsirsdk_Flags
SessionTimeRemainSeconds left till session endss
SessionLapsRemainOld laps left till session ends use SessionLapsRemainEx
SessionLapsRemainExNew improved laps left till session ends
SessionTimeTotalTotal number of seconds in sessions
SessionLapsTotalTotal number of laps in session
SessionJokerLapsRemainJoker laps remaining to be taken
SessionOnJokerLapPlayer is currently completing a joker lap
SessionTimeOfDayTime of day in secondss
RadioTransmitCarIdxThe car index of the current person speaking on the radio
RadioTransmitRadioIdxThe radio index of the current person speaking on the radio
RadioTransmitFrequencyIdxThe frequency index of the current person speaking on the radio
DisplayUnitsDefault units for the user interface 0 = english 1 = metric
DriverMarkerDriver activated flag
PushToTalkPush to talk button state
PushToPassPush to pass button state
ManualBoostHybrid manual boost state
ManualNoBoostHybrid manual no boost state
IsOnTrack1=Car on track physics running with player in car
IsReplayPlaying0=replay not playing 1=replay playing
ReplayFrameNumInteger replay frame number (60 per second)
ReplayFrameNumEndInteger replay frame number from end of tape
IsDiskLoggingEnabled0=disk based telemetry turned off 1=turned on
IsDiskLoggingActive0=disk based telemetry file not being written 1=being written
FrameRateAverage frames per secondfps
CpuUsageFGPercent of available tim fg thread took with a 1 sec avg%
GpuUsagePercent of available tim gpu took with a 1 sec avg%
ChanAvgLatencyCommunications average latencys
ChanLatencyCommunications latencys
ChanQualityCommunications quality%
ChanPartnerQualityPartner communications quality%
CpuUsageBGPercent of available tim bg thread took with a 1 sec avg%
ChanClockSkewCommunications server clock skews
MemPageFaultSecMemory page faults per second
MemSoftPageFaultSecMemory soft page faults per second
PlayerCarPositionPlayers position in race
PlayerCarClassPositionPlayers class position in race
PlayerCarClassPlayer car class id
PlayerTrackSurfacePlayers car track surface typeirsdk_TrkLoc
PlayerTrackSurfaceMaterialPlayers car track surface material typeirsdk_TrkSurf
PlayerCarIdxPlayers carIdx
PlayerCarTeamIncidentCountPlayers team incident count for this session
PlayerCarMyIncidentCountPlayers own incident count for this session
PlayerCarDriverIncidentCountTeams current drivers incident count for this session
PlayerCarWeightPenaltyPlayers weight penaltykg
PlayerCarPowerAdjustPlayers power adjust%
PlayerCarDryTireSetLimitPlayers dry tire set limit
PlayerCarTowTimePlayers car is being towed if time is greater than zeros
PlayerCarInPitStallPlayers car is properly in their pitstall
PlayerCarPitSvStatusPlayers car pit service status bitsirsdk_PitSvStatus
PlayerTireCompoundPlayers car current tire compound
PlayerFastRepairsUsedPlayers car number of fast repairs used
CarIdxLapLaps started by car index
CarIdxLapCompletedLaps completed by car index
CarIdxLapDistPctPercentage distance around lap by car index%
CarIdxTrackSurfaceTrack surface type by car indexirsdk_TrkLoc
CarIdxTrackSurfaceMaterialTrack surface material type by car indexirsdk_TrkSurf
CarIdxOnPitRoadOn pit road between the cones by car index
CarIdxPositionCars position in race by car index
CarIdxClassPositionCars class position in race by car index
CarIdxClassCars class id by car index
CarIdxF2TimeRace time behind leader or fastest lap time otherwises
CarIdxEstTimeEstimated time to reach current location on tracks
CarIdxLastLapTimeCars last lap times
CarIdxBestLapTimeCars best lap times
CarIdxBestLapNumCars best lap number
CarIdxTireCompoundCars current tire compound
CarIdxQualTireCompoundCars Qual tire compound
CarIdxQualTireCompoundLockedCars Qual tire compound is locked-in
CarIdxFastRepairsUsedHow many fast repairs each car has used
CarIdxSessionFlagsSession flags for each playerirsdk_Flags
PaceModeAre we pacing or notirsdk_PaceMode
CarIdxPaceLineWhat line cars are pacing in or -1 if not pacing
CarIdxPaceRowWhat row cars are pacing in or -1 if not pacing
CarIdxPaceFlagsPacing status flags for each carirsdk_PaceFlags
OnPitRoadIs the player car on pit road between the cones
CarIdxSteerSteering wheel angle by car indexrad
CarIdxRPMEngine rpm by car indexrevs/min
CarIdxGear-1=reverse 0=neutral 1..n=current gear by car index
SteeringWheelAngleSteering wheel anglerad
Throttle0=off throttle to 1=full throttle%
Brake0=brake released to 1=max pedal force%
Clutch0=disengaged to 1=fully engaged%
Gear-1=reverse 0=neutral 1..n=current gear
RPMEngine rpmrevs/min
PlayerCarSLFirstRPMShift light first light rpmrevs/min
PlayerCarSLShiftRPMShift light shift rpmrevs/min
PlayerCarSLLastRPMShift light last light rpmrevs/min
PlayerCarSLBlinkRPMShift light blink rpmrevs/min
LapLaps started count
LapCompletedLaps completed count
LapDistMeters traveled from S/F this lapm
LapDistPctPercentage distance around lap%
RaceLapsLaps completed in race
LapBestLapPlayers best lap number
LapBestLapTimePlayers best lap times
LapLastLapTimePlayers last lap times
LapCurrentLapTimeEstimate of players current lap time as shown in F3 boxs
LapLasNLapSeqPlayer num consecutive clean laps completed for N average
LapLastNLapTimePlayer last N average lap times
LapBestNLapLapPlayer last lap in best N average lap time
LapBestNLapTimePlayer best N average lap times
LapDeltaToBestLapDelta time for best laps
LapDeltaToBestLap_DDRate of change of delta time for best laps/s
LapDeltaToBestLap_OKDelta time for best lap is valid
LapDeltaToOptimalLapDelta time for optimal laps
LapDeltaToOptimalLap_DDRate of change of delta time for optimal laps/s
LapDeltaToOptimalLap_OKDelta time for optimal lap is valid
LapDeltaToSessionBestLapDelta time for session best laps
LapDeltaToSessionBestLap_DDRate of change of delta time for session best laps/s
LapDeltaToSessionBestLap_OKDelta time for session best lap is valid
LapDeltaToSessionOptimalLapDelta time for session optimal laps
LapDeltaToSessionOptimalLap_DDRate of change of delta time for session optimal laps/s
LapDeltaToSessionOptimalLap_OKDelta time for session optimal lap is valid
LapDeltaToSessionLastlLapDelta time for session last laps
LapDeltaToSessionLastlLap_DDRate of change of delta time for session last laps/s
LapDeltaToSessionLastlLap_OKDelta time for session last lap is valid
SpeedGPS vehicle speedm/s
YawYaw orientationrad
YawNorthYaw orientation relative to northrad
PitchPitch orientationrad
RollRoll orientationrad
EnterExitResetIndicate action the reset key will take 0 enter 1 exit 2 reset
TrackTempDeprecated set to TrackTempCrewC
TrackTempCrewTemperature of track measured by crew around trackC
AirTempTemperature of air at start/finish lineC
TrackWetnessHow wet is the average track surfaceirsdk_TrackWetness
SkiesSkies (0=clear/1=p cloudy/2=m cloudy/3=overcast)
AirDensityDensity of air at start/finish linekg/m^3
AirPressurePressure of air at start/finish linePa
WindVelWind velocity at start/finish linem/s
WindDirWind direction at start/finish linerad
RelativeHumidityRelative Humidity at start/finish line%
FogLevelFog level at start/finish line%
PrecipitationPrecipitation at start/finish line%
SolarAltitudeSun angle above horizon in radiansrad
SolarAzimuthSun angle clockwise from north in radiansrad
WeatherDeclaredWetThe steward says rain tires can be used
DCLapStatusStatus of driver change lap requirements
DCDriversSoFarNumber of team drivers who have run a stint
OkToReloadTexturesTrue if it is ok to reload car textures at this time
LoadNumTexturesTrue if the car_num texture will be loaded
CarLeftRightNotify if car is to the left or right of driverirsdk_CarLeftRight
PitsOpenTrue if pit stop is allowed for the current player
VidCapEnabledTrue if video capture system is enabled
VidCapActiveTrue if video currently being captured
PitRepairLeftTime left for mandatory pit repairs if repairs are actives
PitOptRepairLeftTime left for optional repairs if repairs are actives
PitstopActiveIs the player getting pit stop service
FastRepairUsedHow many fast repairs used so far
FastRepairAvailableHow many fast repairs left 255 is unlimited
LFTiresUsedHow many left front tires used so far
RFTiresUsedHow many right front tires used so far
LRTiresUsedHow many left rear tires used so far
RRTiresUsedHow many right rear tires used so far
LeftTireSetsUsedHow many left tire sets used so far
RightTireSetsUsedHow many right tire sets used so far
FrontTireSetsUsedHow many front tire sets used so far
RearTireSetsUsedHow many rear tire sets used so far
TireSetsUsedHow many tire sets used so far
LFTiresAvailableHow many left front tires are remaining 255 is unlimited
RFTiresAvailableHow many right front tires are remaining 255 is unlimited
LRTiresAvailableHow many left rear tires are remaining 255 is unlimited
RRTiresAvailableHow many right rear tires are remaining 255 is unlimited
LeftTireSetsAvailableHow many left tire sets are remaining 255 is unlimited
RightTireSetsAvailableHow many right tire sets are remaining 255 is unlimited
FrontTireSetsAvailableHow many front tire sets are remaining 255 is unlimited
RearTireSetsAvailableHow many rear tire sets are remaining 255 is unlimited
TireSetsAvailableHow many tire sets are remaining 255 is unlimited
CamCarIdxActive camera's focus car index
CamCameraNumberActive camera number
CamGroupNumberActive camera group number
CamCameraStateState of camera systemirsdk_CameraState
IsOnTrackCar1=Car on track physics running
IsInGarage1=Car in garage physics running
SteeringWheelAngleMaxSteering wheel max anglerad
ShiftPowerPctFriction torque applied to gears when shifting or grinding%
ShiftGrindRPMRPM of shifter grinding noiseRPM
ThrottleRawRaw throttle input 0=off throttle to 1=full throttle%
BrakeRawRaw brake input 0=brake released to 1=max pedal force%
ClutchRawRaw clutch input 0=disengaged to 1=fully engaged%
HandbrakeRawRaw handbrake input 0=handbrake released to 1=max force%
BrakeABSactivetrue if abs is currently reducing brake force pressure
EngineWarningsBitfield for warning lightsirsdk_EngineWarnings
FuelLevelPctPercent fuel remaining%
PitSvFlagsBitfield of pit service checkboxesirsdk_PitSvFlags
PitSvLFPPit service left front tire pressurekPa
PitSvRFPPit service right front tire pressurekPa
PitSvLRPPit service left rear tire pressurekPa
PitSvRRPPit service right rear tire pressurekPa
PitSvFuelPit service fuel add amountl or kWh
PitSvTireCompoundPit service pending tire compound
CarIdxP2P_StatusPush2Pass active or not
CarIdxP2P_CountPush2Pass count of usage (or remaining in Race)
SteeringWheelPctTorqueForce feedback % max torque on steering shaft unsigned%
SteeringWheelPctTorqueSignForce feedback % max torque on steering shaft signed%
SteeringWheelPctTorqueSignStopsForce feedback % max torque on steering shaft signed stops%
SteeringWheelPctIntensityForce feedback % max intensity%
SteeringWheelPctSmoothingForce feedback % max smoothing%
SteeringWheelPctDamperForce feedback % max damping%
SteeringWheelLimiterForce feedback limiter strength limits impacts and oscillation%
SteeringWheelMaxForceNmValue of strength or max force slider in Nm for FFBN*m
SteeringWheelPeakForceNmPeak torque mapping to direct input units for FFBN*m
SteeringWheelUseLinearTrue if steering wheel force is using linear mode
ShiftIndicatorPctDEPRECATED use DriverCarSLBlinkRPM instead%
ReplayPlaySpeedReplay playback speed
ReplayPlaySlowMotion0=not slow motion 1=replay is in slow motion
ReplaySessionTimeSeconds since replay session starts
ReplaySessionNumReplay session number
TireLF_RumblePitchPlayers LF Tire Sound rumblestrip pitchHz
TireRF_RumblePitchPlayers RF Tire Sound rumblestrip pitchHz
TireLR_RumblePitchPlayers LR Tire Sound rumblestrip pitchHz
TireRR_RumblePitchPlayers RR Tire Sound rumblestrip pitchHz
IsGarageVisible1=Garage screen is visible
SteeringWheelTorque_STOutput torque on steering shaft at 360 HzN*m
SteeringWheelTorqueOutput torque on steering shaftN*m
VelocityZ_STZ velocitym/s at 360 Hz
VelocityY_STY velocitym/s at 360 Hz
VelocityX_STX velocitym/s at 360 Hz
VelocityZZ velocitym/s
VelocityYY velocitym/s
VelocityXX velocitym/s
YawRate_STYaw rate at 360 Hzrad/s
PitchRate_STPitch rate at 360 Hzrad/s
RollRate_STRoll rate at 360 Hzrad/s
YawRateYaw raterad/s
PitchRatePitch raterad/s
RollRateRoll raterad/s
VertAccel_STVertical acceleration (including gravity) at 360 Hzm/s^2
LatAccel_STLateral acceleration (including gravity) at 360 Hzm/s^2
LongAccel_STLongitudinal acceleration (including gravity) at 360 Hzm/s^2
VertAccelVertical acceleration (including gravity)m/s^2
LatAccelLateral acceleration (including gravity)m/s^2
LongAccelLongitudinal acceleration (including gravity)m/s^2
dcStarterIn car trigger car starter
dcPitSpeedLimiterToggleIn car traction control active
dcTractionControlToggleIn car traction control active
dcHeadlightFlashIn car headlight flash control active
dpWindshieldTearoffPitstop windshield tearoff
dcToggleWindshieldWipersIn car turn wipers on or off
dcTriggerWindshieldWipersIn car momentarily turn on wipers
dpRFTireChangePitstop rf tire change request
dpLFTireChangePitstop lf tire change request
dpRRTireChangePitstop rr tire change request
dpLRTireChangePitstop lr tire change request
dpFuelFillPitstop fuel fill flag
dpFuelAddKgPitstop fuel add amountkg
dpFastRepairPitstop fast repair set
dcDashPageIn car dash display page adjustment
dcBrakeBiasIn car brake bias adjustment
dpLFTireColdPressPitstop lf tire cold pressure adjustmentPa
dpRFTireColdPressPitstop rf cold tire pressure adjustmentPa
dpLRTireColdPressPitstop lr tire cold pressure adjustmentPa
dpRRTireColdPressPitstop rr cold tire pressure adjustmentPa
dcThrottleShapeIn car throttle shape adjustment
dcPowerSteeringIn car power steering adjustment
dcTractionControl2In car traction control 2 adjustment
dcTractionControlIn car traction control adjustment
dpFuelAutoFillEnabledPitstop auto fill fuel system enabled
dpFuelAutoFillActivePitstop auto fill fuel next stop flag
RFbrakeLinePressRF brake line pressurebar
RFcoldPressureRF tire cold pressure as set in the garagekPa
RFtempCLRF tire left carcass temperatureC
RFtempCMRF tire middle carcass temperatureC
RFtempCRRF tire right carcass temperatureC
RFwearLRF tire left percent tread remaining%
RFwearMRF tire middle percent tread remaining%
RFwearRRF tire right percent tread remaining%
LFbrakeLinePressLF brake line pressurebar
LFcoldPressureLF tire cold pressure as set in the garagekPa
LFtempCLLF tire left carcass temperatureC
LFtempCMLF tire middle carcass temperatureC
LFtempCRLF tire right carcass temperatureC
LFwearLLF tire left percent tread remaining%
LFwearMLF tire middle percent tread remaining%
LFwearRLF tire right percent tread remaining%
FuelUsePerHourEngine fuel used instantaneouskg/h
VoltageEngine voltageV
WaterTempEngine coolant tempC
WaterLevelEngine coolant levell
FuelPressEngine fuel pressurebar
OilTempEngine oil temperatureC
OilPressEngine oil pressurebar
OilLevelEngine oil levell
ManifoldPressEngine manifold pressurebar
FuelLevelLiters of fuel remainingl
Engine0_RPMEngine0Engine rpmrevs/min
RRbrakeLinePressRR brake line pressurebar
RRcoldPressureRR tire cold pressure as set in the garagekPa
RRtempCLRR tire left carcass temperatureC
RRtempCMRR tire middle carcass temperatureC
RRtempCRRR tire right carcass temperatureC
RRwearLRR tire left percent tread remaining%
RRwearMRR tire middle percent tread remaining%
RRwearRRR tire right percent tread remaining%
LRbrakeLinePressLR brake line pressurebar
LRcoldPressureLR tire cold pressure as set in the garagekPa
LRtempCLLR tire left carcass temperatureC
LRtempCMLR tire middle carcass temperatureC
LRtempCRLR tire right carcass temperatureC
LRwearLLR tire left percent tread remaining%
LRwearMLR tire middle percent tread remaining%
LRwearRLR tire right percent tread remaining%
LRshockDeflLR shock deflectionm
LRshockDefl_STLR shock deflection at 360 Hzm
LRshockVelLR shock velocitym/s
LRshockVel_STLR shock velocity at 360 Hzm/s
RRshockDeflRR shock deflectionm
RRshockDefl_STRR shock deflection at 360 Hzm
RRshockVelRR shock velocitym/s
RRshockVel_STRR shock velocity at 360 Hzm/s
LFshockDeflLF shock deflectionm
LFshockDefl_STLF shock deflection at 360 Hzm
LFshockVelLF shock velocitym/s
LFshockVel_STLF shock velocity at 360 Hzm/s
RFshockDeflRF shock deflectionm
RFshockDefl_STRF shock deflection at 360 Hzm
RFshockVelRF shock velocitym/s
RFshockVel_STRF shock velocity at 360 Hzm/s

These don't change so much...

Label Description
TrackName
TrackID
TrackLength
TrackLengthOfficial
TrackDisplayName
TrackDisplayShortName
TrackConfigName
TrackCity
TrackCountry
TrackAltitude
TrackLatitude
TrackLongitude
TrackNorthOffset
TrackNumTurns
TrackPitSpeedLimit
TrackType
TrackDirection
TrackWeatherType
TrackSkies
TrackSurfaceTemp
TrackAirTemp
TrackAirPressure
TrackWindVel
TrackWindDir
TrackRelativeHumidity
TrackFogLevel
TrackPrecipitation
TrackCleanup
TrackDynamicTrack
TrackVersion
SeriesID
SeasonID
SessionID
SubSessionID
LeagueID
Official
RaceWeek
EventType
Category
SimMode
TeamRacing
MinDrivers
MaxDrivers
DCRuleSet
QualifierMustStartRace
NumCarClasses
NumCarTypes
HeatRacing
BuildType
BuildTarget
BuildVersion
RaceFarm
WeekendOptions
LabelDescription
NumStarters
StartingGrid
QualifyScoring
CourseCautions
StandingStart
ShortParadeLap
Restarts
WeatherType
Skies
WindDirection
WindSpeed
WeatherTemp
RelativeHumidity
FogLevel
TimeOfDay
Date
EarthRotationSpeedupFactor
Unofficial
CommercialMode
NightMode
IsFixedSetup
StrictLapsChecking
HasOpenRegistration
HardcoreLevel
NumJokerLaps
IncidentLimit
FastRepairsLimit
GreenWhiteCheckeredLimit
TelemetryOptions
LabelDescription
TelemetryDiskFile

This is the results bit.

Label Description
Sessions
LabelDescription
SessionNum
SessionLaps
SessionTime
SessionNumLapsToAvg
SessionType
SessionTrackRubberState
SessionName
SessionSubType
SessionSkipped
SessionRunGroupsUsed
SessionEnforceTireCompoundChange
ResultsPositions
LabelDescription
Position
ClassPosition
CarIdx
Lap
Time
FastestLap
FastestTime
LastTime
LapsLed
LapsComplete
JokerLapsComplete
LapsDriven
Incidents
ReasonOutId
ReasonOutStr
ResultsFastestLap
LabelDescription
CarIdx
FastestLap
FastestTime
ResultsAverageLapTime
ResultsNumCautionFlags
ResultsNumCautionLaps
ResultsNumLeadChanges
ResultsLapsComplete
ResultsOfficial

Information on the cameras loaded.

Label Description
Groups
LabelDescription
GroupNum
GroupName
Cameras
LabelDescription
CameraNum
CameraName

Information on the radio channels set up.

Label Description
SelectedRadioNum
Radios
LabelDescription
RadioNum
HopCount
NumFrequencies
TunedToFrequencyNum
ScanningIsOn
Frequencies

Information on the drivers

Label Description
DriverCarIdx
DriverUserID
PaceCarIdx
DriverHeadPosX
DriverHeadPosY
DriverHeadPosZ
DriverCarIsElectric
DriverCarIdleRPM
DriverCarRedLine
DriverCarEngCylinderCount
DriverCarFuelKgPerLtr
DriverCarFuelMaxLtr
DriverCarMaxFuelPct
DriverCarGearNumForward
DriverCarGearNeutral
DriverCarGearReverse
DriverCarSLFirstRPM
DriverCarSLShiftRPM
DriverCarSLLastRPM
DriverCarSLBlinkRPM
DriverCarVersion
DriverPitTrkPct
DriverCarEstLapTime
DriverSetupName
DriverSetupIsModified
DriverSetupLoadTypeName
DriverSetupPassedTech
DriverIncidentCount
Drivers
LabelDescription
CarIdx
UserName
AbbrevName
Initials
UserID
TeamID
TeamName
CarNumber
CarNumberRaw
CarPath
CarClassID
CarID
CarIsPaceCar
CarIsAI
CarIsElectric
CarScreenName
CarScreenNameShort
CarClassShortName
CarClassRelSpeed
CarClassLicenseLevel
CarClassMaxFuelPct
CarClassWeightPenalty
CarClassPowerAdjust
CarClassDryTireSetLimit
CarClassColor
CarClassEstLapTime
IRating
LicLevel
LicSubLevel
LicString
LicColor
IsSpectator
CarDesignStr
HelmetDesignStr
SuitDesignStr
BodyType
FaceType
HelmetType
CarNumberDesignStr
CarSponsor_1
CarSponsor_2
CurDriverIncidentCount
TeamIncidentCount

Give the percentages of the splits.

Label Description
Sectors
LabelDescription
SectorNum
SectorStartPct