Skip to content

Repository files navigation

TachoVision Pro

Versione Python License

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.

Dashboard di TachoVision Pro

Tutte le immagini mostrano i dati di esempio inclusi nel programma (conducente inventato MARIO ROSSI): nessun dato reale.


Novità della versione 0.3.0

  • 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.

Versione 0.2.0

  • 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.

In arrivo

  • lettura dei file scaricati dal tachigrafo del veicolo (velocità, superamenti, calibrazioni, attività di tutti i conducenti).

Schermate

Infrazioni Infrazioni — gravità a stelle, periodo, dettagli e norma Attività Attività — grafico del giorno, inserimenti carta, paesi
Riposo Periodi di riposo — giornalieri, settimanali, compensazioni Pianificazione Pianificazione — prossimi riposi e ore residue
Riepilogo Riepilogo del tempo di lavoro — per giorno o turno Veicoli Utilizzo del veicolo — sessioni, km, posizioni GPS
Luoghi Paesi visitati e luoghi — ore per paese, coordinate Carta Carta — titolare, patente, emissione, scarichi
Impostazioni Impostazioni — legislazione, retribuzione, formati Report Report & Export — invio e archiviazione
PDF attività PDF infrazioni Telefono
PDF attività PDF infrazioni Vista da telefono

Funzionalità

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

Requisiti

  • Python 3.9+ (consigliato 3.10 – 3.13)
  • Windows (testato su Win 10/11) — macOS e Linux supportati

Installazione

Windows — metodo rapido

Doppio clic su installa_windows.bat oppure, da PowerShell:

.\installa_windows.ps1

Lo script installa automaticamente tutte le dipendenze Python e crea sul Desktop il collegamento TachoVision Pro con l'icona del programma.

Manuale (Windows / macOS / Linux)

pip install -r requirements.txt

Lettore smartcard USB (opzionale)

Per leggere la carta direttamente dal lettore fisico USB è necessario pyscard.

Python 3.10 – 3.13 (Windows, macOS) — installazione diretta ✅

pyscard distribuisce wheel pre-compilati su PyPI per Python 3.10, 3.11, 3.12 e 3.13. Nessun compilatore necessario, basta:

pip install pyscard

Python 3.9 o 3.14+ su Windows — Build Tools richiesti ⚠️

Per Python 3.9 su Windows e per Python 3.14 o superiore (wheel non ancora disponibili), è necessario installare prima i Microsoft C++ Build Tools:

  1. Scarica da: visualstudio.microsoft.com/visual-cpp-build-tools
  2. Installa il workload "Sviluppo di applicazioni desktop con C++"
  3. Poi esegui:
    pip install pyscard

Linux — pacchetti di sistema richiesti

# Debian / Ubuntu
sudo apt-get install swig libpcsclite-dev
pip install pyscard

# Fedora / RHEL
sudo dnf install pcsc-lite-devel swig
pip install pyscard

Senza pyscard l'applicazione funziona normalmente caricando file .DDD dal 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.


Avvio

python app.py

Apri 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.

Avvio rapido su Windows

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.ps1

Utilizzo

Prova con i dati di esempio

Nella 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.

Caricamento da file

  1. Clicca "Carica .DDD" nella barra in alto (o trascina il file)
  2. Seleziona il file .DDD della carta tachigrafo
  3. I dati vengono caricati e visualizzati automaticamente

Lettura da lettore USB

  1. Inserisci la carta nel lettore USB collegato al PC
  2. Clicca "Leggi Carta" (oppure attiva la lettura automatica nelle Impostazioni)
  3. 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.

Navigazione

Usa la barra laterale a sinistra per passare tra le schermate. La barra di ricerca in alto filtra il contenuto della schermata corrente.

Archivio locale

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).


Infrazioni rilevate

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.


Configurazione cloud (opzionale)

Google Drive

  1. Vai su console.cloud.google.com
  2. Crea un progetto → Abilita Google Drive API
  3. Credenziali → OAuth 2.0 → App desktop → Scarica JSON
  4. Salva il file come: ~/TachoVision/config/gdrive_credentials.json

OneDrive

Richiede la registrazione di un'applicazione su portal.azure.com:

  1. Azure Active Directory → App registrations → New registration
  2. Copia il Client ID
  3. 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>

Dropbox

Genera un Personal Access Token su dropbox.com/developers/apps e incollalo nella schermata Report & Export.


Struttura del progetto

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

Privacy

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)

Dipendenze principali

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

Licenza

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).


Parole chiave

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

Releases

Packages

Contributors

Languages