Skip to main content

Custom Driver Name

This file explains how to use the Custom Driver Name Mapping feature in RaceLab, which allows you to display custom names for any drivers.

📖 How It Works:​

  • Mappings are stored in a CSV file named drivers.csv in your
    Documents/RaceLabApps/drivermapping folder.
  • You can edit this file to add, remove, or change driver name mappings.
  • RaceLab automatically reloads the file when it detects changes — no restart needed.

📂 File Locations:​

  • Mapping File: drivers.csv
  • Example/Readme File: README.txt

📑 CSV Format:​

The drivers.csv file must use the following columns:

  • source_name_or_id - the original driver name or iracing id
  • display_name - the new driver name

🚀 How to Use:​

  1. Open drivers.csv in a text editor or Excel.
  2. Add a new line for each driver you want to map.
  3. Save the file. RaceLab will automatically reload the changes.

📌 Example:​

Mapping by ID:​

source_name_or_id,display_name
287888,Divebomb Istvan
158445,Wall Magnet Mike

Mapping by Name:​

source_name_or_id,display_name
Istvan Fodor,Divebomb Istvan
Anton Mike,Wall Magnet Mike

Mixed Mapping (Name and ID):​

source_name_or_id,display_name
287888,Divebomb Daniels
Anton Mike,Wall Magnet Mike

🛠️ Troubleshooting:​

  • Ensure no typos or missing columns in drivers.csv.
  • If drivers.csv doesn't exist, RaceLab will generate a sample file.

⚙️ Advanced/Enterprise setups:​

For enterprise sim-racing setups where you want to assign custom names for each pod, we recommend the following approaches:

Simple Setup​

  • Update each pod with the latest drivers.csv mapping file.
  • RaceLab will automatically detect and apply changes when the file is updated.
  • Store the drivers.csv file in a shared folder on a dedicated PC.
  • Configure each pod to sync its RaceLabApps/drivermapping folder with this shared location.
  • With this setup, you only need to update the file on the dedicated PC.
    All pods will automatically receive the latest changes through Windows remote folder sync.
  • RaceLab will automatically detect and apply changes when the file is updated.

For further help, refer to this file or contact RaceLab support: [email protected].