Repository files navigation

This tool allows you to track your stage times in DiRT Rally and DiRT Rally 2.0 and browse them, which the game itself does not allow.

Time tracking works for stage rallies and the Pikes Peak events of the original DiRT Rally.

You can choose to downloaddirt-rally-time-recorder as a ready-to-use bundle (tested to work on Windows 10 x64, read about signing issueshere). You can alsoset it up from scratch.

• Download thelatest release for either the original DiRT Rally or 2.0
  • Unzip the installation folder somewhere
• Start time tracking
  • in your installation folder, starttimerecord.exe
  • It should tell you to beWaiting for data..., otherwise take a look atTroubleshooting

To update to a new version, simply download the new release or create a new bundle as instructed above. To be safe, backup yourdirtrally-laptimes.db. You can overwrite your existing installation folder with the new one.

Make sure to startdirt-rally-time-recorder once to allow to migrate the database and config.

Before starting DiRT Rally [2.0] you need to enable UDP telemetry like so:

• Navigate to the settings directory ofDiRT Rally orDiRT Rally 2.0 (e.g.%USERPROFILE%\Documents\My Games\DiRT Rally 2.0\hardwaresettings\)
• Openhardware_settings_config.xml with a text editor
• Enable telemetry and request extradata by adapting the appropriate line as follows:<udp enabled="true" extradata="3" ...
• Note for VR users: For the VR mode, the above setting has to be adapted inhardware_settings_config_vr.xml as well

There are further configurations and optional features that can be configured inconfig.yml. Please refer to the documentationhere.

• Start DiRT Rally [2.0] and finish a stage
  • dirt-rally-time-recorder runs in the background, reporting the car and the track it identifies from the telemetry
  • for cars, it will display control interface information such as the transmission type (based onthis discussion)
  • it will look something like this:

TRACK: Sweet LambCAR: Volkswagen Golf GTI 16VVolkswagen Golf GTI 16V: H-PATTERN shifting, 5 speed, with manual CLUTCH, with HANDBRAKE

• On stage completion, it reports your top speed and time and saves it to the database
  • to dump the database into a CSV file consumable by your favorite spreadsheet editor, runexport-laptimes.bat
  • to quickly view your recorded times like below, runlist-laptimes.bat

┌───────────────────────────────────────┬────────────────────────────────┬─────────────────────┬───────────┬──────────┐│                 Track                 │              Car               │        Date         │   Time    │ Topspeed │├───────────────────────────────────────┼────────────────────────────────┼─────────────────────┼───────────┼──────────┤│ Annbank Station                       │ Peugeot 205 GTI                │ 2020-07-30 12:47:48 │ 05:32.953 │ 158.4    ││ Anodou Farmakas                       │ Lancia Stratos                 │ 2020-04-26 11:26:44 │ 07:59.897 │ 129.6    ││ Anodou Farmakas                       │ Porsche 911 SC RS              │ 2020-04-14 18:28:20 │ 08:08.114 │ 136.8    │

Since DiRT Rally [2.0] telemetry data doesn't allow to clearly identify every available car and track, this tool will sometimes ask you to resolve this after completing a stage. You canenable heuristics to somewhat alleviate this limitation.

In order to consolidate the database, the tool prepares update scripts for you, e.g.1573403766_ElRodeo_PoloGTIR5.bat

• open your installation folder
• run the update script that matches the car and track you chose (e.g. double-click it)
• you will barely notice a window opening and closing, and that's it
• each time you startdirt-rally-time-recorder, it automatically removes update scripts older than a week

Be aware that this tool cannot know the car or track conditions when recording. In order to beat your best time, choose an undamaged car with proper setup, and ideal track and weather conditions.

Starting:

• to understand MS Defender SmartScreen warnings fordirt-rally-time-recorder, readthis
• if you encounter an error message about sockets, understand that this tool cannot run in parallel, but only in a single instance at the same time
• unless you downloaded the bundled version, have a look atresources/migrate.sql to find instructions how to update to new releases
• if you encounter errors at start-up, see if renaming the filedirtrally-laptimes.db helps (which will create a new database)

Configuring the tool:

• Steam updates of the game sometimes resethardware_settings_config.xml. Then, repeat theconfiguration steps to enable UDP telemetry again
• in case you modified the telemetry host or port inhardware_settings_config.xml, adaptconfig.ymlaccordingly

Recording:

• if the game has been updated with new cars or tracks, recognition can fail ("Unmapped telemetry"). You can continue to record further stages, but you're welcome to report this shortcoming (see below)
• if your installation is too old, recognition can fail as well. Then, check if you can update to anew version ofdirt-rally-time-recorder

Exporting:

• when you export your stage times, be sure to avoid corrupt characters and import the CSV file in a spreadsheet editor with UTF-8 encoding. In MS Excel, use thequery tool

In any case, feel free toopen an issue and attach thetimerecord.log from your installation folder. You can also contact the author throughSteam.

UDP telemetry is availableonly on PC, not consoles.
Linux users refer tothis issue for set up and usage instructions.

UDP telemetry documentation (cf. DiRT 4 for DiRT Rally 2.0):
[https://docs.google.com/spreadsheets/d/1Xsv5E9jwgJsiXCZQlM5Ae2hH5mUnjdHlTtEadnSnaeI/edit?usp=sharing]

Contributors cf. todocs/develop.md.

Tested with

• DiRT Rally (v1.22)
• DiRT Rally 2.0 (v1.18)

Ships with SQLite3.39.4.

UDP data recognition in collaboration with ErlerPhilipp:https://github.com/ErlerPhilipp/dr2_logger.

Thanks to Slocan for the initial version:https://github.com/Slocan/timerecord.

Credits to Billiam for the core code:https://github.com/Billiam/pygauge.

SeeLICENSE andTHIRD_PARTY_LICENSES.txt for works used under license.