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 chiffrés 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)
• ~35 Mo d'espace disque

Installer

1. Téléchargez l'installateur depuis la section téléchargement
2. Exécutez AloxBook-Setup.exe
3. L'application s'installe par utilisateur (pas besoin de droits administrateur)
4. AloxBook enregistre l'extension de fichier .aloxbook pour l'ouverture en double-clic

Alternative en ligne de commande : winget install --id AloxBook.AloxBook -e

Si winget échoue à cause d'une source obsolète, exécutez winget source update puis réessayez. Si la source Store reste défaillante, --source winget peut servir de contournement.

Mises à jour

AloxBook prend en charge les mises à jour automatiques. Lorsqu'une nouvelle version est disponible, l'application vous en informe et se met à jour en arrière-plan.

Mise à jour en ligne de commande : winget upgrade --id AloxBook.AloxBook -e

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 - comptes bancaires, espèces, épargne, prêts, immobilier, ...
• 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 : Compte bancaire - vous recevez votre salaire
• Actifs : Compte bancaire → Dépenses : Alimentation - vous faites vos courses
• Actifs : Compte bancaire → Actifs : É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.

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

Les fichiers AloxBook (.aloxbook) sont des bases de données SQLite chiffrées avec SQLCipher. Lorsque vous créez ou ouvrez un fichier, vous pouvez définir un mot de passe - la base de données entière est alors chiffrée en AES-256 au repos.

Langue & paramètres régionaux

AloxBook prend en charge l'anglais, l'allemand, le français et l'espagnol. 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 dates sont toujours formatés selon les paramètres régionaux de votre système (par ex. 1 234,56 en français vs. 1,234.56 en anglais).

Format de fichier

AloxBook utilise des fichiers .aloxbook - ce sont des bases de données SQLite standard (optionnellement chiffrées avec SQLCipher). Cela signifie :

• Vos données sont dans un seul fichier - facile à sauvegarder, copier ou déplacer
• Aucun service cloud ni base de données externe requis
• SQLite garde les données faciles à consulter avec d'autres outils, y compris des outils compatibles SQLCipher lorsque le fichier est chiffré et que vous connaissez le mot de passe
• Le format est ouvert et peut être inspecté avec n'importe quel outil SQLite (si non chiffré)

Dépannage

L'application ne démarre pas

AloxBook est compilé comme un exécutable Windows natif et devrait fonctionner sur tout système Windows 10+ 64 bits sans dépendances supplémentaires. Si l'application ne démarre pas, essayez de la lancer depuis la ligne de commande pour voir les messages d'erreur :

AloxBook.exe

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