Documentation

AloxBook est pensé pour vous donner une vue claire des finances du quotidien avec une structure simple. Vos données financières sont stockées dans des fichiers SQLite locaux que vous contrôlez, et l'interface rend la partie double compréhensible même si vous la découvrez.

Aperçu

AloxBook utilise la comptabilité en partie double : chaque opération passe d'un compte source à un compte destination. Cette règle simple vous donne une vue fiable de l'origine de l'argent, de sa destination et des raisons d'un changement de solde.

Installation

Configuration requise

• Windows 10 ou ultérieur (64 bits)
• macOS 15 Sequoia ou ultérieur (Apple Silicon ou Intel)
• Linux : Flatpak sur x86_64 ou aarch64, ou AppImage sur x86_64

Installer

Sous Windows, installez de préférence AloxBook depuis le Microsoft Store. Il s'agit du mode d'installation recommandé et les mises à jour sont gérées par le Store. Les paquets directs Setup.exe et WinGet restent disponibles comme solutions alternatives. Pour les autres plateformes, choisissez votre paquet dans la section téléchargement. Son guide d'installation contient les étapes actuelles et les remarques propres à la plateforme. Les paquets AloxBook sont autonomes ; vous n'avez pas besoin d'installer séparément .NET ou d'autres dépendances de l'application.

Mises à jour

• Microsoft Store : les mises à jour des installations provenant du Store sont distribuées par Microsoft Store.
• Setup.exe, WinGet, DMG macOS et AppImage : lorsque la recherche de mises à jour est activée, AloxBook télécharge une nouvelle version en arrière-plan et l'applique après la fermeture de l'application ; la nouvelle version démarre au lancement suivant.
• Flathub : votre logithèque ou flatpak update installe les mises à jour. AloxBook masque donc son propre réglage de mise à jour dans Flatpak.
• Paquet Flatpak direct : cette solution avancée ne possède pas de source de mise à jour gérée. Installez AloxBook depuis Flathub si vous souhaitez des mises à jour automatiques du paquet.

Vérifier un téléchargement direct

Le lien des sommes de contrôle à côté de la version actuelle dans la section téléchargement indique le condensat SHA-256 de chaque fichier publié. Une valeur identique montre que votre fichier correspond au fichier publié ; le manifeste provenant du même site, il ne prouve pas indépendamment l'identité de l'éditeur. Le paquet macOS signé et la fiche Flathub vérifiée offrent des contrôles supplémentaires de l'éditeur.

Premiers pas

1. Créer un nouveau livre - utilisez Fichier → Nouveau et choisissez l'emplacement de votre fichier .aloxbook pour que les sauvegardes restent simples
2. Définir un mot de passe - cela protège le livre si d'autres personnes peuvent accéder au même appareil (optionnel, mais recommandé)
3. Choisir un modèle de comptes - partez d'une structure que vous pourrez renommer et adapter ensuite, plutôt que d'une liste vide
4. Ajouter vos premières opérations - commencez par le salaire, le loyer, les courses, les virements ou d'autres mouvements réguliers

Comptes

Les comptes dans AloxBook sont organisés dans un arbre hiérarchique avec trois catégories principales :

• Actifs et dettes - comptes bancaires, espèces, épargne, immobilier et dettes telles que prêts ou cartes de crédit (soldes négatifs)
• Revenus - salaire, intérêts, dividendes, remboursements, ...
• Dépenses - loyer, alimentation, charges, loisirs, ...

Vous pouvez créer des sous-comptes à n'importe quel niveau. Par exemple, sous Dépenses vous pourriez avoir Logement → Loyer, Logement → Charges, etc. Les soldes s'agrègent vers le haut de l'arbre.

Créer un compte

Passez à l'onglet Comptes, faites un clic droit sur un compte parent (ou utilisez la barre d'outils) et sélectionnez Insérer un compte. Donnez-lui un nom.

Opérations

Une opération dans AloxBook implique toujours deux comptes - l'argent va d'un compte vers un autre. C'est le principe fondamental de la comptabilité en partie double.

Exemples :

• Revenus : Salaire → Actifs et dettes : Compte bancaire - vous recevez votre salaire
• Actifs et dettes : Compte bancaire → Dépenses : Alimentation - vous faites vos courses
• Actifs et dettes : Compte bancaire → Actifs et dettes : Épargne - vous transférez vers votre épargne
• Revenus : Salaire → Dépenses : Alimentation - vous payez la cantine via la fiche de paie

Créer une opération

Dans l'onglet Opérations, cliquez sur l'icône plus. Renseignez la date, le compte source, le compte destination, le montant et le texte de description.

Modèles

Les modèles vous permettent d'enregistrer des opérations fréquentes pour une réutilisation rapide. Un modèle contient le compte source, le compte destination, le montant et le texte de description (tous optionnels).

Pour créer un modèle, allez dans l'onglet Modèles et cliquez sur l'icône plus. Pour appliquer un modèle, sélectionnez-le dans la liste du dialogue « Créer une nouvelle opération » - cela remplit automatiquement les valeurs du modèle dans la nouvelle opération.

Import CSV

AloxBook peut importer des relevés bancaires à partir de fichiers CSV. Le système d'import est hautement configurable :

• Profils d'import sont créés et enregistrés automatiquement après que vous leur avez assigné un compte
• Règles d'import assignent automatiquement les opérations importées à un modèle selon des motifs textuels et des montants
• Chaque opération importée est visible dans un aperçu et peut être modifiée individuellement avant validation
• Détection des doublons pour éviter d'importer les mêmes opérations deux fois

Configurer l'import CSV

1. Passez à l'onglet Opérations
2. Cliquez sur le bouton Importer CSV dans la barre d'outils
3. Sélectionnez votre fichier CSV
4. Le mappage des colonnes est détecté automatiquement ; vous pouvez ajuster les détails manuellement
5. Vérifiez la prévisualisation et cliquez sur Importer

Détection automatique du format

L'import CSV est volontairement générique. Il détecte automatiquement le séparateur, l'encodage du texte, le format de date, le séparateur décimal, les lignes d'en-tête et le rôle des colonnes, de sorte que la plupart des exports bancaires et de cartes s'importent sans aucune configuration manuelle. Si un élément est mal détecté, vous pouvez l'ajuster dans les détails de l'import. Les colonnes débit/crédit séparées ainsi que les champs de référence, description et bénéficiaire séparés par des barres verticales sont également pris en charge.

Formats bancaires vérifiés

Les formats d'export ci-dessous sont contrôlés automatiquement à chaque version à partir de fichiers d'exemple réels ; ils sont donc reconnus d'emblée. Il ne s'agit que d'une sélection de ce qui fonctionne – pas d'une liste exhaustive – et de nombreuses autres banques utilisent des formats très similaires qui s'importent tout aussi bien.

Export CSV

AloxBook peut exporter la vue d'opérations actuellement visible vers un fichier CSV. L'export reprend les mêmes lignes et le même ordre que le tableau des opérations, y compris les filtres et tris actifs.

• Les premières lignes du CSV décrivent le filtre actif et le tri, afin que les fichiers exportés conservent leur contexte
• Les dates et montants sont formatés selon les paramètres régionaux actuels
• Le séparateur suit les paramètres régionaux : point-virgule pour les cultures à virgule décimale, virgule sinon
• Le fichier est écrit en CSV UTF-8 avec marque d'ordre des octets pour une meilleure compatibilité avec les tableurs

Exporter des opérations

1. Passez à l'onglet Opérations
2. Appliquez le filtre ou le tri que vous souhaitez exporter
3. Cliquez sur le bouton Exporter CSV dans la barre d'outils
4. Choisissez le nom et l'emplacement du fichier cible

Clôture & report

Si vous préférez conserver un fichier par période financière (par ex. un par an), la fonctionnalité Clôture & report facilite cela :

1. Allez dans Fichier → Clôture & report
2. AloxBook crée un nouveau fichier avec votre structure de comptes complète
3. Tous les soldes des actifs sont reportés comme soldes d'ouverture
4. Tous les modèles sont reportés
5. Les comptes de revenus et dépenses repartent à zéro
6. Votre ancien fichier reste intact et est marqué comme protégé en écriture

Cela vous donne un nouveau départ pour la nouvelle période tout en préservant votre historique complet dans le fichier précédent.

Chiffrement

La protection par mot de passe est facultative. Lorsqu’un mot de passe est défini, SQLCipher chiffre le livre en AES-256 ; sans mot de passe, le livre est une base de données SQLite non chiffrée. Les mots de passe oubliés ne peuvent pas être récupérés.

Langue & paramètres régionaux

AloxBook prend en charge l'anglais, l'allemand, le français, l'espagnol et l'italien. Vous pouvez changer de langue à tout moment via Paramètres - l'interface entière se met à jour immédiatement sans redémarrage.

Les nombres et les dates utilisent le format régional choisi séparément dans les Paramètres. Système conserve le format du système d'exploitation ; Identique à la langue de l'application suit la langue de l'interface.

Format de fichier

Chaque livre est un unique fichier portable .aloxbook à l'emplacement que vous choisissez. Il contient les comptes, opérations, modèles, paramètres d'import et préférences propres au livre ; aucun dossier de données séparé ne doit l'accompagner.

• Fermez AloxBook avant de copier, déplacer ou sauvegarder le fichier. Toutes les modifications de la base sont ainsi terminées. Si le fichier se trouve dans un dossier synchronisé, attendez aussi la fin de la synchronisation avant d'ouvrir la copie ailleurs.
• Conservez le mot de passe avec vos informations de sauvegarde, mais séparément du livre. Un livre chiffré ne peut pas être récupéré sans lui.
• Avant d'ouvrir pour la première fois un ancien livre important avec une version plus récente d'AloxBook, faites-en une copie normale.

Mises à niveau de la base de données

Une version récente d'AloxBook peut mettre à niveau sur place la structure de la base lorsqu'elle ouvre un ancien livre. Vos données restent dans le même fichier, mais une ancienne version d'AloxBook peut ensuite ne plus pouvoir l'ouvrir. AloxBook refuse d'ouvrir une base créée par une version plus récente non prise en charge plutôt que de tenter une rétrogradation risquée.

Accès et export

Un livre non chiffré est une base SQLite consultable avec les outils SQLite courants. Un livre protégé par mot de passe nécessite un outil compatible SQLCipher et le bon mot de passe. Pour les échanges habituels, utilisez l'export CSV afin d'exporter les opérations actuellement affichées, avec leur filtre et leur ordre. Aucun compte AloxBook ni service cloud n'est nécessaire pour accéder à vos données ou les déplacer.

Dépannage

Problème d'installation ou de démarrage

Les paquets AloxBook officiels incluent leurs dépendances applicatives ; il ne devrait donc pas être nécessaire d'installer .NET séparément. Téléchargez à nouveau le paquet actuel, suivez la remarque de son guide d'installation et comparez le fichier avec la somme SHA-256 publiée. Si le problème persiste, contactez l'assistance en indiquant la version d'AloxBook, la version et l'architecture du système, la source d'installation, le message d'erreur exact et l'étape qui a échoué.

Le fichier ne s'ouvre pas

Si vous obtenez une erreur à l'ouverture d'un fichier, vérifiez :

• Le fichier est-il un fichier .aloxbook valide ?
• Entrez-vous le bon mot de passe ?
• Le fichier a-t-il été créé ou mis à niveau par une version plus récente d'AloxBook ? Mettez AloxBook à jour avant de réessayer.
• Si le fichier vient d'un dossier synchronisé, la copie et la synchronisation étaient-elles terminées après la fermeture d'AloxBook ?
• Le fichier est-il en lecture seule ? AloxBook peut ouvrir les fichiers en lecture seule en mode consultation.

Problèmes d'import CSV

Si le CSV de votre banque ne s'importe pas correctement, vérifiez les paramètres du profil d'import : séparateur (virgule, point-virgule, tabulation), format de date, séparateur décimal et mappage des colonnes. Vous pouvez prévisualiser les données analysées avant l'import pour vérifier que les paramètres sont corrects.

L'export CSV apparaît différemment dans un tableur

L'export CSV utilise vos paramètres régionaux actuels pour les dates, les séparateurs décimaux et le séparateur CSV. Les deux premières lignes indiquent volontairement le filtre actif et le tri afin que le fichier reste compréhensible plus tard.