Download · Documentation · Architecture · Engineering case study

Polski · English

Note

Current pre-release: 0.1.0-beta.12.1. This hotfix clears stale provisional Rest after a manual switch to other work, preventing the UI break counter from being overstated.

Important

This project is an ETS2 simulator. It is not a certified tachograph and must not be used to account for the working time of real drivers.

I wanted to build a desktop product around a genuinely difficult engineering problem: combining live native telemetry, time-based domain rules, durable history, and an interface that remains useful during gameplay. The result is a mixed C# and C++ system rather than a conventional CRUD application.

Mixed C#/.NET 9 and native C++ solution using the official SCS SDK 1.14.

Versioned 32-byte shared-memory protocol with explicit compatibility checks.

Event-driven reconstruction of driver activity across game-time rollbacks.

Rule engine for continuous driving, breaks, daily/weekly rest, and multi-manning within the simulator's implemented scope.

SQLite and EF Core persistence with migrations and pre-migration backups.

Layered retention model: minute-level recent history and compact older blocks.

PDF, CSV, .tacho, and VTC JSON reporting.

571-test hotfix release gate covering domain, application, persistence, telemetry, reporting, and UI-facing behaviour.

Windows GitHub Actions pipeline with Release build, tests, TRX results, and Cobertura coverage artifacts.

Capability Implementation Live activity capture Reads official ETS2 telemetry and detects driving automatically. Two-driver operation Models two card slots, card swaps, and multi-manning scenarios. Driving-time analysis Calculates continuous, daily, weekly, and fortnightly counters. History reconstruction Preserves one logical timeline through clock rollbacks and world reloads. Durable storage Stores activity in SQLite and protects migrations with automatic backups. Reporting Produces readable PDF blocks plus diagnostic CSV and JSON exports.

Loading

See the architecture document for component boundaries, data flow, invariants, and failure handling.

The current public build is 0.1.0-beta.12, published as a self-contained Windows x64 pre-release.

Download the application package from Releases.

Copy ETS2Tachograph.ScsPlugin.dll to the ETS2 bin\win_x64\plugins directory.

Run ETS2Tachograph.Desktop.exe from the application directory.

Read the complete English installation guide or the Polish installation guide before first use.

Requirements:

.NET SDK 9.0.311;

Visual Studio 2022 with Desktop development with C++;

Windows SDK;

official SCS SDK 1.14 headers under third_party/scs_sdk_1_14.

The native plugin is built separately as Release|x64 from native/ETS2Tachograph.ScsPlugin/ETS2Tachograph.ScsPlugin.vcxproj.

The product is deliberately presented with its current trade-offs. The largest remaining maintenance item is splitting the oversized MainViewModel into feature view models. ActivityRepository has already been separated into focused files for sessions, gaps, canonical projection, retention, manual entries, and writes. The remaining UI refactor is planned, but it is not needed to hide a known correctness problem in the current release.

Original project code is licensed under the MIT License. Third-party components remain subject to their own terms listed in THIRD_PARTY_NOTICES.md. Third-party names and trademarks remain the property of their respective owners.