Applicazione web locale per analizzare le carte tachigrafo digitali (file .DDD).
Legge la carta direttamente da un lettore USB smartcard oppure dal file salvato.
Legge file .DDD di prima e seconda generazione (Gen1 / Gen2), controlla i tempi di
guida, lavoro e riposo secondo il Reg. CE 561/2006 e la Dir. 2002/15/CE, pianifica
le ore residue ed esporta PDF ed Excel — tutto in locale, senza cloud, senza account,
senza abbonamento.
⚠️ Versione Beta — il software è funzionante ma potrebbero esserci bug. Per segnalazioni apri una Issue su GitHub.
Tutte le immagini mostrano i dati di esempio inclusi nel programma (conducente inventato MARIO ROSSI): nessun dato reale.
- Tema scuro (oppure automatico, come il sistema) e 26 lingue dell'interfaccia: italiano, inglese, tedesco, francese, spagnolo, portoghese, olandese, polacco, rumeno, ceco, slovacco, sloveno, croato, serbo, ungherese, bulgaro, greco, russo, ucraino, turco, svedese, danese, norvegese, finlandese, estone, lettone e lituano.
- Lettura della carta completa per le carte di seconda generazione: vengono copiate
entrambe le parti della carta (Gen1 e Gen2) con certificati e firme digitali, così il
file
.DDDè valido anche per i controlli. Barra di avanzamento durante la lettura, consigli se il lettore non viene trovato e scrittura della data di scarico sulla carta. - Nome del file standard:
C_<data UTC>_<iniziale>_<COGNOME>_<numero carta>.DDD. - Dati Gen2 uniti: luoghi, veicoli (con numero di telaio), eventi e guasti della parte Gen2 della carta si uniscono a quelli della parte Gen1, senza doppioni.
- Carte Gen2 versione 2: attraversamenti di frontiera e operazioni di carico e scarico merce, con data, paese e posizione GPS.
- Posizioni GPS corrette: le coordinate erano lette con un'unità sbagliata e i punti finivano a decine di chilometri dal posto giusto.
- Nomi con caratteri speciali: nomi e autorità con le lettere delle altre lingue europee (greco, cirillico, lettere accentate) vengono letti correttamente.
- Scelta dei riposi più favorevole al conducente quando un riposo può contare in più modi; nuove regole: spostamenti senza veicolo registrato, simbolo del paese al valico di frontiera, superamento consentito dall'Art. 12, guida notturna nei servizi bus.
- Secondo conducente: lette anche le attività registrate con la carta nello slot 2.
- Infrazioni raggruppate per tipo, anche nel PDF, con scelta dei campi firma; controllo del lavoro continuo (max 6 ore) in Pianificazione; mappa GPS punto per punto.
- Invii cloud non persi: se la rete manca il file resta in coda e viene inviato al successivo avvio.
- Cartella di salvataggio a scelta per una copia di ogni carta letta e opzione per mascherare il numero di carta nelle schermate e nei PDF.
- Nuovo aspetto "Carta disco" con il disco 24 ore nella Dashboard.
- Motore delle infrazioni su linea del tempo continua, gravità MI / SI / VSI / MSI (Reg. UE 2016/403), regole italiane, filtri per periodo, gravità e tipo.
- Storico del conducente (unione degli scarichi, dati mancanti, scarico entro 28 giorni).
- Schermate Periodi di riposo, Pianificazione, Riepilogo del tempo di lavoro, Paesi visitati, Utilizzo del veicolo, Impostazioni complete; dati inseriti a mano.
- Export PDF ed Excel rifatti; archivio con backup, ripristino e zip; dati di esempio.
- lettura dei file scaricati dal tachigrafo del veicolo (velocità, superamenti, calibrazioni, attività di tutti i conducenti).
| PDF attività | PDF infrazioni | Telefono |
|---|---|---|
![]() |
![]() |
![]() |
| Schermata | Cosa mostra |
|---|---|
| Dashboard | Disco 24 ore della giornata, verdetto sulle ultime 8 settimane, guida residua |
| Infrazioni | Violazioni Reg. CE 561/2006 e Dir. 2002/15/CE con gravità, periodo e dettagli |
| Riposo | Riposi giornalieri e settimanali, turni, guida settimanale e bisettimanale, compensazioni |
| Pianificazione | Situazione allo scarico, prossimi orari di fine riposo, simulazione di lavoro/riposo |
| Attività | Elenco e grafico per giorno, inserimento/estrazione carta, paesi, eventi, dati manuali |
| Riepilogo | Tempo di lavoro per giorno o turno, settimanale o mensile, pause retribuite, fascia oraria maggiorata |
| Veicoli | Sessioni di guida per veicolo con odometro, km, riepiloghi e mappa GPS |
| Luoghi | Paesi visitati con ore e distanze, luoghi con coordinate GNSS, frontiere e carico/scarico (Gen2 v2) |
| Carta | Titolare, carta, patente, emissione, eventi e guasti registrati |
| Archivio | File .DDD salvati, promemoria 28 giorni, backup/ripristino, zip, storico conducente |
| Report & Export | Invio con il client e-mail, upload su Google Drive / OneDrive / Dropbox |
| Impostazioni | 26 lingue, tema chiaro/scuro, fuso orario, paese base, legislazione, retribuzione, colori, formati |
Export (con periodo Dal/Al): PDF Attività (anche solo grafico), Riepilogo del tempo di lavoro, Utilizzo del veicolo, Paesi visitati, Periodi di riposo, Infrazioni; Excel (CSV con BOM, separatore a scelta) per attività, tempo di lavoro, veicoli, posizioni GPS e paesi.
Formati supportati:
- Gen1 (Reg. CE 1360/2002 / Reg. 3821/85)
- Gen2 V1 (Reg. UE 2016/799) — con dati GNSS
- Gen2 V2 — con buffer attività a coppia UTC/locale
- Estensioni
.DDD,.esm,.tgd,.C1B
- Python 3.9+ (consigliato 3.10 – 3.13)
- Windows (testato su Win 10/11) — macOS e Linux supportati
Doppio clic su installa_windows.bat oppure, da PowerShell:
.\installa_windows.ps1Lo script installa automaticamente tutte le dipendenze Python e crea sul Desktop il collegamento TachoVision Pro con l'icona del programma.
pip install -r requirements.txtPer leggere la carta direttamente dal lettore fisico USB è necessario pyscard.
pyscard distribuisce wheel pre-compilati su PyPI per Python 3.10, 3.11, 3.12 e 3.13. Nessun compilatore necessario, basta:
pip install pyscardPer Python 3.9 su Windows e per Python 3.14 o superiore (wheel non ancora disponibili), è necessario installare prima i Microsoft C++ Build Tools:
- Scarica da: visualstudio.microsoft.com/visual-cpp-build-tools
- Installa il workload "Sviluppo di applicazioni desktop con C++"
- Poi esegui:
pip install pyscard
# Debian / Ubuntu
sudo apt-get install swig libpcsclite-dev
pip install pyscard
# Fedora / RHEL
sudo dnf install pcsc-lite-devel swig
pip install pyscardSenza pyscard l'applicazione funziona normalmente caricando file
.DDDdal disco. Gli script di installazione Windows (installa_windows.bat/.ps1) gestiscono automaticamente entrambi i casi: provano prima il wheel, poi mostrano le istruzioni Build Tools solo se necessario.
python app.pyApri il browser su: http://localhost:8050
Il programma è accessibile anche dagli altri dispositivi sulla stessa rete locale
(http://<ip-del-pc>:8050), anche da telefono.
Doppio clic sul collegamento TachoVision Pro sul Desktop (oppure su start_app.bat).
Si apre la finestra del programma: premi INVIO per aprire la pagina nel browser,
anche più volte se chiudi la scheda. Per fermare il programma chiudi la finestra.
Il collegamento si può ricreare in qualsiasi momento con:
.\crea_collegamento.ps1Nella schermata iniziale clicca "Prova con dati di esempio": vengono caricate 9 settimane di attività inventate (conducente MARIO ROSSI) con veicoli, viaggio all'estero, posizioni GPS e alcune infrazioni tipiche.
- Clicca "Carica .DDD" nella barra in alto (o trascina il file)
- Seleziona il file
.DDDdella carta tachigrafo - I dati vengono caricati e visualizzati automaticamente
- Inserisci la carta nel lettore USB collegato al PC
- Clicca "Leggi Carta" (oppure attiva la lettura automatica nelle Impostazioni)
- Attendi il completamento della lettura (10-60 secondi): accanto al pulsante si vede il punto a cui è arrivata
Il file viene salvato automaticamente nell'archivio locale (e, se scelta, anche in una cartella a parte). Per le carte Gen2 vengono lette entrambe le parti, con le firme digitali. Con l'opzione "Timestamp della carta" (attiva di base) la carta registra la data della lettura, come dopo uno scarico ufficiale.
Usa la barra laterale a sinistra per passare tra le schermate. La barra di ricerca in alto filtra il contenuto della schermata corrente.
La schermata Archivio conserva tutti i file .DDD letti o caricati, con backup e
ripristino su file. Un promemoria avvisa quando si avvicina la scadenza dei 28 giorni per
lo scarico della carta (obbligo di legge).
Implementate secondo Reg. CE 561/2006, Reg. UE 165/2014 e Dir. 2002/15/CE, con la gravità dell'Allegato I del Reg. UE 2016/403:
| Gruppo | Controlli |
|---|---|
| Tempo di guida | Guida continua > 4h30 (Art. 7), giornaliera > 9h / 10h (Art. 6§1), settimanale > 56h, bisettimanale > 90h, guida notturna bus |
| Riposo | Giornaliero regolare, ridotto, frazionato, in multipresenza (Art. 8); settimanale < 45h / < 24h, in ritardo, due ridotti all'estero non compensati, riposo regolare nel veicolo |
| Orario di lavoro | Settimanale > 48h / 60h, lavoro notturno > 10h, pause dopo 6h e 9h, lavoro continuo > 6h |
| Uso del tachigrafo | Simbolo del paese, inserimento manuale mancante, commutatore di fine giornata e traghetto/treno |
| Varie | Ispezione del veicolo prima della partenza, scarico della carta entro 28 giorni, dati mancanti tra due scarichi |
Le soglie e la modalità nazionale (es. regole italiane sul lavoro notturno) si regolano nelle Impostazioni.
- Vai su console.cloud.google.com
- Crea un progetto → Abilita Google Drive API
- Credenziali → OAuth 2.0 → App desktop → Scarica JSON
- Salva il file come:
~/TachoVision/config/gdrive_credentials.json
Richiede la registrazione di un'applicazione su portal.azure.com:
- Azure Active Directory → App registrations → New registration
- Copia il Client ID
- Imposta la variabile d'ambiente:
# Windows set TACHOVISION_MSAL_CLIENT_ID=<il-tuo-client-id> # macOS / Linux export TACHOVISION_MSAL_CLIENT_ID=<il-tuo-client-id>
Genera un Personal Access Token su dropbox.com/developers/apps e incollalo nella schermata Report & Export.
tachovision-pro/
├── app.py ← entry point: avvio server + layout
├── requirements.txt
├── installa_windows.bat / .ps1 ← installazione automatica Windows
├── start_app.bat ← avvio rapido Windows (INVIO apre il browser)
├── crea_collegamento.ps1 ← collegamento con icona sul Desktop
├── models/
│ ├── parser.py ← lettore binario .DDD (Gen1 + Gen2)
│ ├── card_data.py ← dataclass: CardData, Vehicle, Place…
│ ├── timeline.py ← linea del tempo continua, riposi e turni
│ ├── violations.py ← motore delle infrazioni
│ ├── history.py ← storico unito degli scarichi del conducente
│ ├── rest_report.py ← periodi di riposo e compensazioni
│ ├── planning.py ← pianificazione e simulazione
│ ├── worktime.py ← riepilogo del tempo di lavoro
│ ├── vehicle_report.py ← utilizzo veicoli e paesi visitati
│ ├── day_events.py ← righe giornaliere delle attività
│ ├── manual_data.py ← note, ferie e attività inserite a mano
│ ├── settings.py ← impostazioni
│ └── demo_data.py ← dati di esempio inventati
├── locales/ ← testi dell'interfaccia nelle 26 lingue
├── views/
│ ├── i18n.py ← traduzione dell'interfaccia
│ ├── theme.py ← colori e caratteri del tema "Carta disco"
│ ├── charts.py ← grafici (disco 24 ore, giornate, riepiloghi)
│ └── tabs/ ← una schermata = un file Python
├── controllers/ ← callback Dash di ogni schermata
├── services/
│ ├── card_service.py ← lettura smartcard USB (pyscard)
│ ├── report_service.py ← export PDF ed Excel con periodo Dal/Al
│ ├── pdf_canvas.py ← disegno dei PDF su pagina A4
│ ├── archive_service.py ← archivio .DDD, backup, zip
│ ├── accessories.py ← promemoria 28 giorni, backup settimanale
│ ├── email_service.py ← apertura client email locale
│ └── cloud_service.py ← Google Drive / OneDrive / Dropbox
├── tests/ ← test automatici (pytest, solo dati inventati)
└── assets/
├── style.css ← tema "Carta disco"
├── filter.js ← ricerca globale
└── sidebar.js ← navigazione
I file .DDD contengono dati personali sensibili del conducente (identità, spostamenti, orari).
- Il programma gira interamente in locale: nessun dato viene trasmesso a server esterni
- I file vengono salvati solo nella cartella
~/TachoVision/archivio/del PC - L'upload cloud (Drive / OneDrive / Dropbox) avviene solo se configurato manualmente dall'utente
- Il trattamento dei dati tachigrafi è regolato dal Reg. CE 561/2006 e dal GDPR (Reg. UE 2016/679)
| Libreria | Versione | Uso |
|---|---|---|
| Dash | ≥ 2.17 | Framework web reattivo |
| Plotly | ≥ 5.22 | Grafici interattivi |
| Dash Bootstrap Components | ≥ 1.6 | Layout e componenti UI |
| pandas | ≥ 2.0 | Elaborazione dati tabellari |
| ReportLab | ≥ 4.0 | Generazione PDF |
| pyscard | opzionale | Lettura smartcard USB |
Distribuito per uso personale e professionale nel rispetto delle normative sul trattamento dei dati tachigrafo (Reg. CE 561/2006, Dir. 2006/22/CE, Reg. UE 2016/679).
tachigrafo digitale · carta conducente · file DDD · lettore tachigrafo · analisi tachigrafo · digital tachograph · tachograph card reader · DDD file viewer · driver card analyzer · scarico carta tachigrafo · infrazioni tachigrafo · Reg. 561/2006 · orario conducenti · tempi guida e riposo · pianificazione riposi · tachograph analysis software · open source tachograph













