acd.py

Python module for reading and writing Assetto Corsa Data (.acd) files.

Documentation

You can find the documentation for the library here.

Installation

To install the in-development version, run the following:

pip install git+https://github.com/philippkosarev/acd.py.git

A stable version should be coming soon.

Notes about the .acd file format

• Most .acd files do not have a signature, so it's usually impossible to check whether a given file is actualy a .acd file without attempting to read it.
• Moving or renaming a .acd file can make it impossible to decrypt because the encryption key is generated based on either the basename or dirname of the specific file (see the docs for a more in-depth explanation).

Using the library

See the documentation for examples on how to use the library.

Using the CLI

The acd CLI provides only 3 commands: view, unpack and pack. The names of the commands are pretty self-explanatory, but this is how they work in action:

To view what's inside a .acd file, you can run acd view.

$ acd view data.acd
Available items:
  1) aero.ini                    17) drs.ini                    33) suspension_graphics.ini
  2) ai.ini                      18) electronics.ini            34) suspensions.ini
  3) ambient_shadows.ini         19) engine.ini                 35) tcurve_wdt_front.lut
  4) analog_instruments.ini      20) escmode.ini                36) tcurve_wdt_rear.lut
  5) analog_speed_curve.lut      21) fin_AOA_CD.lut             37) throttle.lut
  6) analog_turbo_curve.lut      22) fin_AOA_CL.lut             38) tyres.ini
  7) blurred_objects.ini         23) final.rto                  39) tyres_wdt.lut
  8) brakes.ini                  24) flame_presets.ini          40) wing_animations.ini
  9) cameras.ini                 25) flames.ini                 41) wing_body_AOA_CD.lut
  10) car.ini                    26) lights.ini                 42) wing_body_AOA_CL.lut
  11) colliders.ini              27) lods.ini                   43) wing_front_AOA_CD.lut
  12) damage.ini                 28) mirrors.ini                44) wing_front_AOA_CL.lut
  13) dash_cam.ini               29) power.lut                  45) wing_rear_AOA_CD.lut
  14) digital_instruments.ini    30) proview_nodes.ini          46) wing_rear_AOA_CL.lut
  15) driver3d.ini               31) setup.ini
  16) drivetrain.ini             32) sounds.ini

Select which item to view (1-46, 0 to abort): 2
[GEARS]
UP=6900
DOWN=4000
SLIP_THRESHOLD=0.95
GAS_CUTOFF_TIME=0.300

[PEDALS]
GASGAIN=4.0
BRAKE_HINT=0.87
TRAIL_HINT=0.5

[STEER]
STEER_GAIN=1.61

[LOOKAHEAD]
BASE=17.1
GAS_BRAKE_LOOKAHEAD=10

[HEADER]
VERSION=3

[ULTRA_GRIP]
VALUE=1.2

[PHYSICS_HINTS]
AERO_HINT=1

To pack a directory into a .acd file, you can run acd pack.

$ ls data_dir
aero.ini                 electronics.ini          suspensions.ini
ai.ini                   engine.ini               tcurve_wdt_front.lut
ambient_shadows.ini      escmode.ini              tcurve_wdt_rear.lut
analog_instruments.ini   final.rto                throttle.lut
analog_speed_curve.lut   fin_AOA_CD.lut           tyres.ini
blurred_objects.ini      fin_AOA_CL.lut           tyres_wdt.lut
brakes.ini               fuel_cons.ini            wing_animations.ini
cameras.ini              lights.ini               wing_body_AOA_CD.lut
car.ini                  lods.ini                 wing_body_AOA_CL.lut
colliders.ini            mirrors.ini              wing_front_AOA_CD.lut
damage.ini               power.lut                wing_front_AOA_CL.lut
dash_cam.ini             proview_nodes.ini        wing_rear_AOA_CD.lut
digital_instruments.ini  setup.ini                wing_rear_AOA_CL.lut
driver3d.ini             sounds.ini
drivetrain.ini           suspension_graphics.ini
$ acd pack data_dir data.acd

To unpack the contents of a .acd file into a directory, you can use acd unpack.

$ acd unpack data.acd data_dir
$ ls data_dir
aero.ini                 electronics.ini          suspensions.ini
ai.ini                   engine.ini               tcurve_wdt_front.lut
ambient_shadows.ini      escmode.ini              tcurve_wdt_rear.lut
analog_instruments.ini   final.rto                throttle.lut
analog_speed_curve.lut   fin_AOA_CD.lut           tyres.ini
blurred_objects.ini      fin_AOA_CL.lut           tyres_wdt.lut
brakes.ini               fuel_cons.ini            wing_animations.ini
cameras.ini              lights.ini               wing_body_AOA_CD.lut
car.ini                  lods.ini                 wing_body_AOA_CL.lut
colliders.ini            mirrors.ini              wing_front_AOA_CD.lut
damage.ini               power.lut                wing_front_AOA_CL.lut
dash_cam.ini             proview_nodes.ini        wing_rear_AOA_CD.lut
digital_instruments.ini  setup.ini                wing_rear_AOA_CL.lut
driver3d.ini             sounds.ini
drivetrain.ini           suspension_graphics.ini