An all-in-one installer that gets SimHub and CrewChief running on Linux, including telemetry bridging via Winecarte so they can read data from Linux-native and Proton-based sim titles.
Supported games include: Assetto Corsa, Assetto Corsa Competizione, Assetto Corsa Evo, Assetto Corsa Rally, rFactor 2, Automobilista 2, Project Cars 2, Le Mans Ultimate, and American/Euro Truck Simulator 2.
SimHub and CrewChief are Windows applications. On Linux, Windows software is run using a compatibility layer called Wine. The catch is that sim racing games write their telemetry data (speed, gear, lap times, etc.) to a region of memory that Wine-hosted apps can't normally see.
This installer sets up everything needed to bridge that gap using Winecarte. Winecarte has two components: Winehub, which maps shared memory from Linux into the Wine environment (so SimHub and CrewChief can read game telemetry), and winecarte-run, which does the reverse — exposing Wine shared memory to Linux applications.
Before running the installer, make sure the following are installed on your system. If you're not sure how to install them, search for instructions for your specific Linux distribution (e.g. Ubuntu, Fedora, Arch).
- Wine — runs Windows applications on Linux
- Winetricks — a helper tool for setting up Wine
- curl — for downloading files (usually pre-installed)
- unzip — for extracting downloaded archives (usually pre-installed)
Important: Choose where you want to keep this folder before running the installer. The install location gets baked into the desktop launchers for SimHub and CrewChief. If you move the folder later, just re-run
install.shfrom the new location to fix everything up.
-
Open a terminal and download the installer:
git clone https://github.com/srounce/linux-simracing-utils
If you don't have
git, you can also download a ZIP from GitHub and extract it. -
Move into the folder:
cd linux-simracing-utils -
Run the installer:
bash install.sh
-
Follow the prompts. The installer will ask whether you want to install or skip each component — SimHub, CrewChief, and Winecarte. You can safely press Enter to accept the defaults.
The installer will download and set everything up, including a dedicated Wine environment so SimHub and CrewChief don't interfere with any other Wine applications you might have.
For SimHub and CrewChief to receive telemetry, each game needs to be launched via winecarte-run. This tells Winecarte to expose the game's shared memory to Wine so the apps can read it.
For each game in Steam:
-
Right-click the game in your Steam library and select Properties
-
In the General tab, find the Launch Options field
-
Enter the following, replacing the path with the actual location of your
linux-simracing-utilsfolder:/path/to/linux-simracing-utils/bin/winecarte-run %command%For example, if you cloned the repo to your home folder:
~/linux-simracing-utils/bin/winecarte-run %command%
The %command% part is important — it tells Steam to run the game itself after winecarte-run.
Once installation is complete, SimHub and CrewChief will appear in your application menu (the same place you launch other apps). Launch them from there as normal.
Winehub starts automatically in the background when you open either app, bridging the game's shared memory into Wine so SimHub and CrewChief can read the telemetry. It shuts down cleanly when you close the apps. You don't need to do anything special to make it work.
Re-run the installer at any time to update to the latest versions:
bash install.shIt detects what's already installed and offers to update each component rather than reinstalling from scratch. You can update just one app and skip the others.
Re-run the installer from the new location:
bash install.shThis will also fix up the desktop launchers for SimHub and CrewChief to point to the new location.
install.sh # the installer
bin/ # helper scripts and tools (created by the installer)
pfx/ # the Wine environment (created by the installer)
log/ # install and runtime logs (created by the installer)
Install logs are saved to the log/ folder inside the project directory. If something goes wrong during installation, check the relevant log file there for details.
If you need to debug runtime issues, you can enable verbose output by setting DEBUG=1 before running any of the scripts:
DEBUG=1 bash install.sh- SimHub_on_Linux by @srlemke — Provided initial inspiration for this project and was a helpful reference for various aspects of the processes involved. Big shoutout to @srlemke for his work on this.