Vehiculos

Présentation

Vehiculos est un carnet d'entretien de véhicule avec une logique simple : vos données vous appartiennent.

Contrairement aux applications modernes qui stockent vos informations sur des serveurs distants et pompent vos données, Vehiculos enregistre ce que vous voulez sur votre ordinateur, dans des formats ouverts et lisibles. Vous pouvez sauvegarder, copier, ou modifier vos fichiers en dehors de l'application. Au besoin vous pouvez aussi stocker ces données sur un autre support ou sur votre espace cloud (à vous de voir).

Installation, désinstallation, compilation

Si vous avez téléchargé le fichier .deb, double-cliquez dessus et lancez l'installation avec votre gestionnaire de paquets par défaut.

Le programme s'installera et vous pourrez le retrouver dans vos applications, dans la rubrique Accessoires

Si vous avez téléchargé le .Zip (pour Windows), Dézippez-le, placez le .exe où vous voulez et lancez-le.

Compilation

…Ou bien compilez le programme après l'avoir cloné depuis le dépôt git (ou téléchargé l'archive).

Installer les dépendances

sudo apt update

sudo apt install build-essential pkg-config libgtk-4-dev libzip-dev

Pour compiler

gcc -Wall -Wextra *.c -o vehiculos $(pkg-config --cflags --libs gtk4 libzip)

Lancer le programme

./vehiculos (ou double-clic sur l'icône du fichier)

Désinstallation

Sous Linux, en mode superutilisateur ou root : `apt purge vehiculos`

Les fichiers de configuration sont normalement dans `home` : `.config/vehiculos`

Démarrage

Le coffre (vault)

Lors de votre toute première ouverture de Vehiculos, l'application vous demande de configurer un coffre.

Le coffre est simplement un dossier sur votre ordinateur (par exemple : Documents/Carnets_Entretien/). C'est à l'intérieur de ce dossier que Vehiculos rangera tous vos véhicules. Vous pouvez placer ce dossier sur votre disque dur, sur une clé USB ou dans un dossier synchronisé (comme Nextcloud , Infomaniak, Dropbox...).

Ajouter un véhicule

Une fois le coffre créé, vous serez invité·e à créer votre premier véhicule.

Vous pouvez renseigner :

• Le nom (ex: Ma Clio, Mon VTT)
• L'immatriculation ou l'identifiant (optionnel)
• La marque (optionnel)
• L'émoji : choisissez un symbole visuel pour identifier votre véhicule (🚗, 🏍, 🚲, etc.).

Vous pouvez ajouter autant de véhicules que vous le souhaitez dans un même coffre via le menu principal. Pour passer d'un véhicule à un autre, cliquez simplement sur le bouton 🔧 Véhicules en bas de l'écran.

L’interface

Elle se divise en trois zones :

L’en-tête. Vous y trouverez affichés le nom, la marque et l’immatriculation du véhicule actuellement sélectionné.

Le tableau de suivi. Les interventions y sont triées de la plus récente à la plus ancienne.

• ID : numéro unique de l’intervention.
• Date : date de l’intervention.
• Description : l’opération réalisée. Les interventions plus anciennes portant le même nom s’affichent en gris.
• KM : le kilométrage au moment de l’intervention.
• Diff : le nombre de kilomètres parcourus depuis cette intervention (à condition de mettre à jour le kilométrage actuel).
• Doc. : un bouton 📎 pour ouvrir la facture associée.
• Notes : vos commentaires additionnels (affichés sur plusieurs lignes si nécessaire).

La barre d’actions (en bas). Permet de mettre à jour le kilométrage, d’ajouter une intervention, de changer de véhicule et d’accéder au menu principal.

Gérer ses interventions

Ajouter une intervention réalisée

Cliquez sur le bouton “➕ Intervention”.

• Type : choisissez entre Entretien (révision courante) ou Réparation (panne imprévue).
• Date : par défaut à la date du jour, vous pouvez la modifier en cliquant sur le calendrier 📅.
• Kilométrage : le kilométrage du véhicule le jour de l’intervention.
• Description : saisissez l’opération (limité à 50 caractères). Le menu déroulant juste à côté vous propose les descriptions que vous avez déjà utilisées par le passé. Ce n’est pas seulement pour gagner du temps : voir plus haut.
• Notes : max. 200 caractères pour détailler l’opération (marques des pièces, constatations, etc.).
• Joindre document : attacher un document à cette intervention : *.jpg, *.jpeg, *.jpe, *.png, *.webp, *.pdf, *.txt, *.md, *.markdown, *.odt, *.ods, *.doc, *.docx, *.xls, *.xlsx

Modifier ou Supprimer une intervention

Il suffit de double-cliquer sur n’importe quelle ligne du tableau. Une petite fenêtre vous demandera si vous souhaitez modifier l’intervention ou la supprimer définitivement.

Planifier une intervention

Si vous savez que vous devez prévoir une intervention (par exemple, changer vos pneus dans 6 mois), utilisez le menu principal et choisissez Planifier une intervention.

L’interface est allégée. Saisissez la date future, l’opération et le kilométrage estimé.

• Dans le tableau, cette intervention apparaîtra en rouge pour se distinguer.
• Si la date prévue est dépassée et que vous n’avez rien fait, l’application vous l’indiquera.
• Une fois l’opération réalisée, double-cliquez sur la ligne et choisissez Déclarer réalisée. L’application vous laissera alors entrer le kilométrage réel, joindre la facture finale, et ajouter vos notes.

Mettre à jour le kilométrage actuel

Le kilométrage de votre véhicule évolue constamment. Pour maintenir vos données à jour, cliquez sur le bouton rouge ✏ KM en bas à gauche.

Saisissez votre kilométrage du jour. Cette action est très importante : c’est elle qui permet à Vehiculos de calculer le champ Diff (Différentiel) dans le tableau, vous indiquant combien de kilomètres ont été parcourus depuis chaque intervention (par exemple, depuis la dernière révision des freins).

Exporter ses données

Vos données sont utiles si vous pouvez les partager (lors de la revente du véhicule, par exemple). Le menu principal propose ce choix :

• Export HTML Simple : génère une page Web contenant l’historique du véhicule. Vous pouvez alors l’imprimer sur papier ou la convertir en PDF depuis votre navigateur Web.
• Export Complet (ZIP) : Vehiculos génère un fichier .zip contenant la page Web ET des sous-dossiers contenant tous vos documents. Si vous décompressez ce .zip et ouvrez la page web, vous pourrez cliquer sur les liens qui renvoient à vos documents.

Les réglages

Dans cette section, vous pouvez modifier la langue, modifier l'affichage des dates et modifier le système de mesure (métrique ou impérial).

Après avoir validé ces changements, un redémarrage du programme est nécessaire. Une pop-up vous invitera à relancer le programme

Comprendre l’architecture des fichiers

Aucune base de données obscure n’est utilisée. Si vous ouvrez le dossier-coffre que vous avez défini sur votre ordinateur, voici ce que vous y trouverez :

L’arborescence des dossiers

📁 Mon_Coffre/
│
├── 📁 Ma_Voiture/
│   ├── 📄 vehiculdata.csv
│   ├── 📄 database.csv
│   ├── 📄 mileage.txt
│   ├── 📁 maintenance/ (Contient vos documents d'entretien)
│   └── 📁 repair/      (Contient vos documents de réparation)
│
└── 📁 Mon_Velo/
├── 📄 vehiculdata.csv
└── ...

Note : Les fichiers que vous importez via l’application sont automatiquement copiés dans maintenance ou repair. Pour éviter tout risque d’écrasement de fichiers portant le même nom (ex: « facture.pdf »), Vehiculos ajoute automatiquement la date et l’heure système devant le nom du fichier (ex: 20260525143000_facture.pdf).

Les fichiers

Si l’application Vehiculos venait à disparaître, ou si vous souhaitez traiter vos données sur Excel, LibreOffice Calc, ou un simple bloc-notes, vous le pouvez ! Voici comment lire les trois fichiers textes présents dans le dossier de chaque véhicule.

Le fichier mileage.txt

Il contient une seule ligne avec le dernier kilométrage enregistré.

Le fichier vehiculdata.csv

Il contient les informations de base du véhicule, séparées par le symbole | (barre verticale).

Nom du véhicule | Immatriculation | Marque | Émoji

(Exemple : Ma voiture|AB-123-CD|Renault Clio|🚗)

Le fichier database.csv

Chaque ligne correspond à une intervention. Les champs sont séparés par le symbole |. La structure est la suivante :

Identifiant | Nom du véhicule | Description | Notes | Kilométrage | Date | Chemin_du_document

• Identifiant : Commence par MAINTEN (entretien / maintenance) ou REPAIR (réparation) suivi d’un numéro.
• Notes : Si vous avez fait des retours à la ligne dans l’application, ils sont encodés sous la forme \n dans le fichier pour ne pas casser la structure. Une ligne planifiée portera la mention “INTERVENTION PLANIFIÉE”.

Vous pouvez éditer ces fichiers manuellement, tant que vous respectez scrupuleusement la séparation avec les barres verticales |.