Hitéa

Outils

Tirelire Vigie SecureSend Explicateur crontab Quel LLM local ? Générateur de QR code Tout le catalogue

Contenu

Blog Guides
— Software · 7 min de lecture

Tirelire : l'appli de budget open source qui garde vos comptes chez vous

Tirelire importe vos relevés CSV, range vos dépenses par règles, repère vos abonnements et prévoit votre solde de fin de mois, sur votre propre serveur. Ce qu'elle fait, comment l'installer, et ses limites.

Tirelire : l'appli de budget open source qui garde vos comptes chez vous

Les applis de budget grand public demandent presque toutes la même chose : vos identifiants bancaires, ou un accès permanent à vos comptes via un agrégateur, et vos relevés stockés sur leurs serveurs. En échange, elles rangent vos dépenses. Tirelire part du principe inverse : l'appli tourne chez vous, lit les fichiers CSV que votre banque vous laisse déjà télécharger, et garde tout dans un seul fichier sur votre serveur.

Précision utile avant d'aller plus loin : Tirelire est un projet maison. Il est publié par hitea sur GitHub, sous licence Apache-2.0, gratuit et open source. Sa vitrine est sur la page Tirelire de la boîte à outils. Ce qui suit décrit ce qu'il fait, et aussi ce qu'il ne fait pas.

Ce que c'est, concrètement

Tirelire est une appli web de budget personnel, auto-hébergée et pensée d'abord pour le téléphone. On l'installe sur un serveur, un NAS ou une machine du homelab, puis on l'ouvre dans le navigateur du mobile. L'interface existe en français et en anglais.

Elle est conçue pour un foyer : une instance, un jeu de comptes, partagé par les personnes qui gèrent le même argent. Ce n'est pas un service à plusieurs locataires, et ce choix a une conséquence qu'on retrouvera dans les limites : tous les comptes utilisateurs voient toutes les données.

Côté technique, c'est une application Laravel 13 avec Livewire 4 et Tailwind 4, sous PHP 8.4. Les données vivent dans une base SQLite, donc dans un seul fichier : rien à administrer, et une sauvegarde qui se résume à copier ce fichier (ou le volume Docker qui le contient).

Du relevé CSV au budget

Le point de départ, c'est l'export CSV de la banque. Tirelire reconnaît le format tout seul : Crédit Mutuel, Trade Republic et N26 pour l'instant. La liste est courte, mais l'architecture est faite pour s'allonger : chaque banque est lue par une petite classe PHP, et en ajouter une revient à écrire cette classe, l'enregistrer dans la configuration et fournir un test sur un exemple anonymisé.

Deux détails rendent l'import vivable au quotidien. Importer deux fichiers qui se chevauchent ne crée pas de doublons. Et une opération saisie à la main, en attendant le relevé, est remplacée par la ligne de la banque quand celle-ci arrive. On peut donc noter une dépense le jour même sans la compter deux fois ensuite.

Viennent ensuite les catégories. Le principe est volontairement simple : une règle est un texte cherché dans le libellé bancaire. Si le libellé contient tel nom d'enseigne, l'opération va dans telle catégorie. Les règles se gèrent dans l'appli, avec un aperçu des opérations qu'une règle va toucher et une recatégorisation en un clic. Des règles génériques pour les enseignes et services français courants sont fournies au départ ; pour le reste (votre employeur, les commerces du quartier), on ajoute les siennes, dans l'interface ou dans un fichier JSON chargé à l'installation.

Avec des opérations rangées, les budgets mensuels par catégorie prennent sens. Pour chaque catégorie, Tirelire affiche la moyenne des trois mois précédents comme repère : on fixe un plafond en sachant d'où l'on part, plutôt qu'au doigt mouillé.

Abonnements et prévision : les deux écrans utiles

La détection des paiements récurrents est sans doute la fonction qui sert le plus vite. Loyer, crédits, assurances, abonnements mensuels ou annuels : Tirelire les repère dans l'historique, en résistant aux montants ponctuels et aux hausses de prix (l'abonnement qui passe de 9,99 à 11,99 euros reste le même abonnement). On peut en marquer un « à résilier » pour voir l'économie possible avant de passer à l'acte.

L'autre écran est la prévision. Il répond aux questions qu'on se pose vraiment en milieu de mois :

  • quel solde attendre à la fin du mois ;
  • combien mettre de côté sans passer à découvert ;
  • si le mois en cours va plus vite ou moins vite que la moyenne ;
  • quels prélèvements arrivent dans les prochains jours.

Pour que ces chiffres restent justes, les virements internes (versement sur le livret, passage d'un compte à l'autre) sont exclus des statistiques de revenus et de dépenses. Sans ce tri, chaque virement vers l'épargne ressemblerait à une dépense, et chaque retour à un revenu. Les comptes peuvent être plusieurs, et le solde de chacun est repris du relevé bancaire plutôt que recalculé.

Dernier confort, le mode privé masque les montants à l'écran, pour consulter ses comptes dans le métro sans les montrer au voisin. Le projet le dit lui-même : c'est un affichage, pas une fonction de sécurité.

L'installer et l'essayer

La méthode recommandée passe par Docker. L'image est basée sur FrankenPHP et tourne sans droits root. Quatre commandes suffisent :

  • git clone https://github.com/HiteaFR/tirelire.git
  • cd tirelire
  • docker compose up -d --build
  • docker compose exec app php artisan finance:user you@example.com

La dernière crée votre compte : il n'y a pas d'inscription publique, les utilisateurs se créent en ligne de commande. L'appli répond ensuite sur http://localhost:8080. Pour voir à quoi elle ressemble avant d'y mettre ses vrais relevés, une commande remplit une instance vide avec des données de démonstration inventées : docker compose exec app php artisan db:seed --class=DemoSeeder.

Trois points à retenir pour une installation durable :

  • la base SQLite et la clé de l'application sont dans le volume tirelire-data : c'est lui qu'il faut sauvegarder ;
  • le port n'est publié que sur 127.0.0.1 : pour y accéder depuis le téléphone, il faut un reverse proxy en HTTPS devant, avec les réglages TRUSTED_PROXIES et SESSION_SECURE_COOKIE décrits dans le README ;
  • la mise à jour tient en une ligne, git pull puis docker compose up -d --build, et les migrations s'appliquent au démarrage.

Une installation sans Docker est aussi documentée, sur un serveur avec PHP 8.4 et l'extension pdo_sqlite, Composer et Node 22 pour compiler l'interface.

Sécurité et limites

Par défaut, Tirelire ferme ce qui doit l'être : pas d'inscription publique, des mots de passe d'au moins 12 caractères, un nombre de tentatives de connexion limité, et un changement de mot de passe qui déconnecte les sessions ouvertes.

Les limites, elles, sont écrites noir sur blanc dans le dépôt, et il vaut mieux les connaître avant d'y confier ses comptes :

  • Aucune isolation entre utilisateurs. Tout compte qui peut se connecter voit tout. C'est cohérent avec l'idée d'un foyer, pas avec un usage partagé entre colocataires qui gardent leurs finances séparées.
  • Pas de chiffrement sur le disque. Les données ne sont pas chiffrées au repos : la protection repose sur celle du serveur, du volume Docker et des sauvegardes.
  • Une seule devise. Le symbole et le format des nombres se règlent, mais l'appli ne gère pas plusieurs monnaies.
  • La France d'abord. Trois banques reconnues pour l'instant et des règles génériques pensées pour les enseignes françaises. Ailleurs, il faudra écrire ses règles, voire le lecteur de sa banque.

Enfin, Tirelire n'importe que des fichiers : il ne se connecte pas à votre banque. C'est une limite (il faut télécharger le relevé de temps en temps) et c'est aussi tout l'intérêt : aucun tiers n'a d'accès à vos comptes.

Pour qui ?

Tirelire s'adresse à ceux qui ont déjà un serveur à la maison, ou l'envie d'en avoir un, et qui veulent suivre leur budget sans confier leurs relevés à un service en ligne. Il conviendra mieux à un foyer client d'une des banques reconnues, ou prêt à écrire quelques règles. Ceux qui cherchent une synchronisation bancaire automatique ou une gestion multi-devises iront voir ailleurs.

Le plus simple pour se faire une idée reste la démo : un docker compose up, la commande des données inventées, et dix minutes à parcourir les écrans de prévision et d'abonnements. Les captures et la procédure complète sont sur la page Tirelire.

Partager