Tachoparser is an open-source Go toolkit for parsing and verifying digital tachograph data files (DDD format) as specified by EU regulations. It supports 1st generation (digital tachograph), 2nd generation (smart tachograph), and 2nd generation v2 formats for both vehicle unit (VU) and driver card data. Output is structured JSON, ready for downstream analysis or integration.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/traconiq/tachoparser/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Parse your first tachograph file in minutes with the dddparser CLI
Installation
Build from source or run with Docker — all setup options covered
CLI Reference
Full flag reference for dddparser, dddsimple, dddserver, and dddui
gRPC API
Integrate tachograph parsing as a microservice with the gRPC server
What Tachoparser does
Tachoparser reads raw binary tachograph data from files or stdin and outputs fully decoded JSON. It handles the complex binary TLV/TV encoding used by EU-regulated tachograph devices, including cryptographic signature verification against official ERCA public key certificates.Vehicle Unit data
Parse complete VU datasets including activities, events, faults, and GPS records
Driver card data
Decode driver card files with activity history, place records, and holder identity
Signature verification
Verify data integrity using EU ERCA root and member state certificates
Docker deployment
Run dddserver as a containerized gRPC service with the official Dockerfile
How it works
Download public key certificates
Obtain EU ERCA root CA and member state certificates using the provided Python download scripts, or download them manually from the JRC Digital Tachograph portal.
Build the executables
Run
./build-binaries-prod.sh from the repository root to compile all five executables: dddparser, dddsimple, dddserver, dddclient, and dddui.Parse a tachograph file
Pipe a DDD file to
dddparser with the -vu or -card flag and receive structured JSON on stdout.Supported formats
| Format | Generation | VU Data | Driver Card |
|---|---|---|---|
| Digital Tachograph | 1st gen | ✓ | ✓ |
| Smart Tachograph | 2nd gen | ✓ | ✓ |
| Smart Tachograph v2 | 2nd gen v2 | ✓ | ✓ |
Tachoparser is based on the EU regulatory specifications defined in Commission Implementing Regulation (EU) 2016/799 and its amendments. Data structures are extracted directly from the official annexes.