Skip to content

adnanademovic/simetry

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

simetry

Rust library for interfacing with telemetry of various racing and driving sims.

The library is under active development, and the generic interface for handling all sims is yet to be designed.

Currently supported sims:

  • iRacing
  • Assetto Corsa
  • Assetto Corsa Competizione
  • rFactor 2 (extra steps for enabling described below)
  • DiRT Rally 2.0
  • Euro Truck Simulator 2 (extra steps for enabling described below)
  • American Truck Simulator (extra steps for enabling described below)

Beyond that, an interface for a generic HTTP server exists, allowing you to easily emulate any sim to see the functionality of your software that way, instead of having to run the sim and replicating scenarios manually.

All implementations provide a Client which retries connections forever with Client::connect() and generates its own SimState.

Besides that, iRacing provides a DiskClient for reading recorded telemetry data, and commands for sending commands to iRacing.

Examples of capabilities are available in examples.

The most generic way of use is using simetry::connect to connect to whatever sim is currently running with a generic client, and querying that way.

That generic way currently only supports some basic capabilities, and if you need more than what's present there, you can use the interface of the individual sims.

Extra Configuration

rFactor 2

Requires adding the DLLs from https://github.com/TheIronWolfModding/rF2SharedMemoryMapPlugin.

Euro Truck Simulator 2 and American Truck Simulator

Requires adding the DLLs from https://github.com/RenCloud/scs-sdk-plugin.

Alternatively supporting also https://github.com/Funbit/ets2-telemetry-server via simetry::truck_simulator::json_client::Client.