Skip to main content

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.

Tachoparser turns raw binary tachograph data into structured JSON with a single command. This guide walks you from a fresh clone to a working parse of both a vehicle unit file and a driver card file.
1

Clone the repository

git clone https://github.com/traconiq/tachoparser.git
cd tachoparser
2

Download EU public key certificates

Tachoparser verifies cryptographic signatures in tachograph data using official EU ERCA certificates. Without them, parsing still works — signatures just won’t be verified.
cd scripts/pks1
./dl_all_pks1.py
cd ../pks2
./dl_all_pks2.py
cd ../..
See Download EU tachograph public key certificates for manual download instructions and details on what the certificates are used for.
3

Build all executables

From the repository root, run the build script. You’ll need Go 1.19 or later installed.
./build-binaries-prod.sh
This builds five executables: dddparser, dddsimple, dddserver, dddclient, and dddui. Each is placed in its corresponding cmd/ subdirectory.
If you only need a specific tool, you can build it individually. See Installation for per-binary build instructions.
4

Parse a vehicle unit file

The dddparser binary reads raw data from stdin and writes JSON to stdout. Pass -vu for vehicle unit data:
cat tachodata.ddd | ./cmd/dddparser/dddparser -vu
Errors and warnings go to stderr, so you can safely pipe the JSON without interference.
5

Parse a driver card file

Use -card instead of -vu for driver card data:
cat drivercard.ddd | ./cmd/dddparser/dddparser -card
-card and -vu are mutually exclusive — you must specify exactly one.
6

Pretty-print and explore the output

The output is compact JSON by default. Use the -format flag for indented output, or pipe through jq for interactive exploration:
# Built-in pretty-printing
cat tachodata.ddd | ./cmd/dddparser/dddparser -vu -format

# jq for interactive exploration
cat tachodata.ddd | ./cmd/dddparser/dddparser -vu | jq . | less

# Extract a specific field
cat tachodata.ddd | ./cmd/dddparser/dddparser -vu | jq '.vu_overview_first_gen'

​
What’s next

dddparser reference

All flags for the main parser, including file I/O and batch mode

dddsimple

Quickly extract identification numbers and driver names without full parsing

Output format

Understand the JSON structure and how to work with parsed data

gRPC server

Deploy Tachoparser as a microservice with the dddserver gRPC API

Build docs developers (and LLMs) love

Get started for freeTalk to us