Dokumentation

AloxBook soll Ihnen eine klare Sicht auf den finanziellen Alltag geben mit einer einfachen Struktur. Ihre Transaktionsdaten werden in lokalen SQLite-Dateien unter Ihrer Kontrolle gespeichert, und die Oberfläche macht doppelte Buchführung auch dann verständlich, wenn Sie diese gerade erst kennenlernen.

Überblick

AloxBook arbeitet mit doppelter Buchführung: Jede Transaktion bewegt Geld von einem Quellkonto zu einem Zielkonto. Diese einfache Regel zeigt zuverlässig, woher Geld kommt, wohin es geht und warum sich Salden verändern.

Installation

Systemanforderungen

• Windows 10 oder neuer (64-Bit)
• macOS 15 Sequoia oder neuer (Apple Silicon oder Intel)
• Linux: Flatpak auf x86_64 oder aarch64, oder AppImage auf x86_64

Installieren

Installieren Sie AloxBook unter Windows vorzugsweise aus dem Microsoft Store. Dies ist der empfohlene Installationsweg und bietet vom Store verwaltete Updates. Das direkte Setup.exe-Paket und WinGet bleiben als Alternativen verfügbar. Wählen Sie für andere Plattformen Ihr Paket im Download-Bereich. Die jeweilige Installationsanleitung enthält die aktuellen Schritte und bekannte plattformspezifische Hinweise. AloxBook-Pakete sind eigenständig; .NET oder andere Anwendungsabhängigkeiten müssen nicht separat installiert werden.

Updates

• Microsoft Store: Updates für Store-Installationen werden über den Microsoft Store bereitgestellt.
• Setup.exe, WinGet, macOS-DMG und AppImage: Wenn die Update-Suche aktiviert ist, lädt AloxBook eine neue Version im Hintergrund herunter und wendet sie nach dem Beenden an; beim nächsten Start läuft die neue Version.
• Flathub: Ihr Software-Center oder flatpak update installiert Updates. Deshalb blendet AloxBook in Flatpak die eigene Update-Einstellung aus.
• Direktes Flatpak-Paket: Diese Alternative für erfahrene Benutzer hat keine verwaltete Update-Quelle. Verwenden Sie Flathub, wenn Sie automatische Paket-Updates wünschen.

Direkten Download prüfen

Der Prüfsummen-Link neben der aktuellen Version im Download-Bereich enthält den SHA-256-Wert jeder Release-Datei. Ein übereinstimmender Wert zeigt, dass Ihre Datei der veröffentlichten Release-Datei entspricht. Da das Manifest von derselben Website kommt, beweist es die Herausgeberidentität nicht unabhängig. Das signierte macOS-Paket und der verifizierte Flathub-Eintrag bieten zusätzliche Herausgeberprüfungen.

Erste Schritte

1. Neues Buch erstellen - verwenden Sie Datei → Neu und wählen Sie den Ort Ihrer .aloxbook-Datei so, dass Backups einfach bleiben
2. Passwort festlegen - damit schützen Sie das Buch, wenn auch andere Personen Zugriff auf dasselbe Gerät haben (optional, aber empfohlen)
3. Kontenvorlage wählen - starten Sie mit einer Struktur, die Sie später umbenennen und anpassen können, statt mit einer leeren Liste zu beginnen
4. Erste Transaktionen erfassen - beginnen Sie mit Gehalt, Miete, Einkäufen, Überweisungen oder anderen wiederkehrenden Geldbewegungen

Konten

Konten in AloxBook sind in einem hierarchischen Baum mit drei Hauptkategorien organisiert:

• Vermögen & Schulden - Bankkonten, Bargeld, Sparguthaben, Immobilien und Schulden wie Kredite oder Kreditkarten (als negative Salden)
• Einnahmen - Gehalt, Zinsen, Dividenden, Rückerstattungen, ...
• Ausgaben - Miete, Lebensmittel, Nebenkosten, Unterhaltung, ...

Sie können auf jeder Ebene Unterkonten erstellen. Zum Beispiel unter Ausgaben: Wohnen → Miete, Wohnen → Nebenkosten usw. Salden werden im Baum nach oben aggregiert.

Konto erstellen

Wechseln Sie zum Tab Konten, klicken Sie mit der rechten Maustaste auf ein übergeordnetes Konto (oder verwenden Sie die Werkzeugleiste) und wählen Sie Konto einfügen. Vergeben Sie einen Namen.

Transaktionen

Eine Transaktion in AloxBook umfasst immer zwei Konten - Geld fließt von einem Konto zu einem anderen. Das ist das Grundprinzip der doppelten Buchführung.

Beispiele:

• Einnahmen: Gehalt → Vermögen & Schulden: Bankkonto - Sie erhalten Ihr Gehalt
• Vermögen & Schulden: Bankkonto → Ausgaben: Lebensmittel - Sie kaufen Lebensmittel
• Vermögen & Schulden: Bankkonto → Vermögen & Schulden: Sparguthaben - Sie überweisen auf Ihr Sparkonto
• Einnahmen: Gehalt → Ausgaben: Lebensmittel - Sie bezahlen das Essen in der Kantine über die Gehaltsabrechnung

Transaktion erstellen

Klicken Sie im Tab Transaktionen auf das Plus-Symbol. Geben Sie Datum, Quellkonto, Zielkonto, Betrag und Transaktionstext ein.

Vorlagen

Mit Vorlagen können Sie häufig verwendete Transaktionen zur schnellen Wiederverwendung speichern. Eine Vorlage enthält Quellkonto, Zielkonto, Betrag und Transaktionstext (alle optional).

Um eine Vorlage zu erstellen, gehen Sie zum Tab Vorlagen und klicken Sie auf das Plus-Symbol. Um eine Vorlage anzuwenden, wählen Sie sie im "Neue Transaktion erstellen" Dialog aus der Liste aus - dies übernimmt die Werte der Vorlage automatisch in die neue Transaktion.

CSV-Import

AloxBook kann Kontoauszüge aus CSV-Dateien importieren. Das Importsystem ist hochkonfigurierbar:

• Importprofile werden automatisch erstellt und gespeichert, nachdem Sie ihm ein Konto zugewiesen haben
• Importregeln weisen importierte Transaktionen automatisch anhand von Textmustern und Beträgen zu einer Vorlage zu
• Jede importierte Transaktion ist in einer Vorschau sichtbar und kann einzeln bearbeitet werden, bevor sie übernommen wird
• Duplikaterkennung verhindert den doppelten Import derselben Transaktionen

CSV-Import einrichten

1. Wechseln Sie zum Tab Transaktionen
2. Klicken Sie auf die Schaltfläche CSV importieren in der Werkzeugleiste
3. Wählen Sie Ihre CSV-Datei aus
4. Die Spaltenzuordnung wird automatisch erkannt, Sie können in den Details manuell Anpassungen vornehmen
5. Überprüfen Sie die Vorschau und klicken Sie auf Importieren

Automatische Formaterkennung

Der CSV-Import ist bewusst generisch aufgebaut. Trennzeichen, Textkodierung, Datumsformat, Dezimaltrennzeichen, Kopfzeilen und Spaltenrollen werden automatisch erkannt, sodass sich die meisten Bank- und Kreditkartenexporte ohne manuelle Einrichtung importieren lassen. Wird etwas falsch erkannt, können Sie es in den Importdetails anpassen. Separate Soll/Haben-Spalten sowie mit senkrechten Strichen getrennte Referenz-, Beschreibungs- und Empfängerfelder werden ebenfalls unterstützt.

Geprüfte Bankformate

Die folgenden Exportformate werden bei jeder Veröffentlichung automatisch gegen echte Beispieldateien geprüft und werden daher zuverlässig erkannt. Dies ist nur eine Auswahl des Möglichen – keine vollständige Liste – und viele weitere Banken verwenden sehr ähnliche Formate, die ebenso gut importiert werden.

CSV-Export

AloxBook kann die aktuell sichtbare Transaktionsansicht als CSV-Datei exportieren. Der Export verwendet genau die Zeilen und die Reihenfolge, die Sie in der Transaktionstabelle sehen, inklusive aktiver Filter und Sortierung.

• Die ersten CSV-Zeilen beschreiben den aktiven Filter und die Sortierung, damit exportierte Dateien ihren Kontext behalten
• Datums- und Betragswerte werden gemäß dem aktuellen Gebietsschema formatiert
• Das Trennzeichen folgt dem Gebietsschema: Semikolon bei Komma-Dezimaltrennzeichen, sonst Komma
• Die Datei wird als UTF-8-CSV mit Byte Order Mark geschrieben, damit Tabellenkalkulationen sie besser erkennen

Transaktionen exportieren

1. Wechseln Sie zum Tab Transaktionen
2. Wenden Sie den gewünschten Filter oder die gewünschte Sortierung an
3. Klicken Sie auf die Schaltfläche CSV exportieren in der Werkzeugleiste
4. Wählen Sie Dateiname und Speicherort aus

Abschluss & Übertragen

Wenn Sie eine Datei pro Finanzperiode bevorzugen (z.B. eine pro Jahr), erleichtert die Funktion Abschluss & Übertragen dies:

1. Gehen Sie zu Datei → Abschluss & Übertragen
2. AloxBook erstellt eine neue Datei mit Ihrer vollständigen Kontenstruktur
3. Alle Vermögenssalden werden als Anfangssalden vorgetragen
4. Alle Vorlagen werden übertragen
5. Einnahmen- und Ausgabenkonten beginnen bei null
6. Ihre alte Datei bleibt unverändert und wird mit einem "Schreibschutz" versehen

So erhalten Sie einen sauberen Start für die neue Periode und bewahren gleichzeitig Ihre vollständige Historie in der vorherigen Datei.

Verschlüsselung

Der Passwortschutz ist optional. Wenn ein Passwort gesetzt ist, verschlüsselt SQLCipher das Buch mit AES-256; ohne Passwort ist das Buch eine unverschlüsselte SQLite-Datenbank. Vergessene Passwörter können nicht wiederhergestellt werden.

Sprache & Gebietsschema

AloxBook unterstützt Englisch, Deutsch, Französisch, Spanisch und Italienisch. Sie können die Sprache jederzeit über Einstellungen ändern - die gesamte Benutzeroberfläche wird sofort aktualisiert, ohne Neustart.

Zahlen und Datumsangaben verwenden das unter Einstellungen separat gewählte Regionsformat. System behält das Format des Betriebssystems bei; Anwendungssprache übernehmen folgt der Oberflächensprache.

Dateiformat

Jedes Buch ist eine einzelne portable .aloxbook-Datei am von Ihnen gewählten Speicherort. Sie enthält Konten, Transaktionen, Vorlagen, Importeinstellungen und buchbezogene Einstellungen; es gibt keinen separaten Datenordner, der mitkopiert werden muss.

• Schließen Sie AloxBook, bevor Sie die Datei kopieren, verschieben oder sichern. So sind alle Datenbankänderungen abgeschlossen. Liegt die Datei in einem synchronisierten Ordner, warten Sie außerdem das Ende der Synchronisierung ab, bevor Sie die Kopie anderswo öffnen.
• Bewahren Sie das Passwort bei Ihren Sicherungsinformationen auf, aber getrennt vom Buch. Ein verschlüsseltes Buch kann ohne Passwort nicht wiederhergestellt werden.
• Erstellen Sie vor dem ersten Öffnen eines wichtigen älteren Buchs mit einer neueren AloxBook-Version eine normale Dateikopie.

Datenbank-Upgrades

Eine neuere AloxBook-Version kann beim Öffnen eines älteren Buchs dessen Datenbankstruktur direkt aktualisieren. Ihre Daten bleiben in derselben Datei, eine ältere AloxBook-Version kann sie danach jedoch möglicherweise nicht mehr öffnen. Eine Datenbank aus einer neueren, nicht unterstützten Version wird von AloxBook abgewiesen, statt eine unsichere Rückstufung zu versuchen.

Zugriff und Export

Ein unverschlüsseltes Buch ist eine SQLite-Datenbank und kann mit üblichen SQLite-Werkzeugen untersucht werden. Für ein passwortgeschütztes Buch benötigen Sie ein SQLCipher-kompatibles Werkzeug und das richtige Passwort. Für den normalen Datenaustausch verwenden Sie den CSV-Export; er exportiert die aktuell angezeigten Transaktionen einschließlich Filter und Sortierung. Für Zugriff und Transport Ihrer Daten sind weder ein AloxBook-Konto noch ein Cloud-Dienst erforderlich.

Fehlerbehebung

Installations- oder Startproblem

Offizielle AloxBook-Pakete enthalten ihre Anwendungsabhängigkeiten; .NET muss daher nicht separat installiert werden. Laden Sie das aktuelle Paket erneut herunter, beachten Sie den Hinweis in seiner Installationsanleitung und vergleichen Sie die Datei mit der veröffentlichten SHA-256-Prüfsumme. Falls das Problem bleibt, kontaktieren Sie den Support mit AloxBook-Version, Betriebssystemversion und Architektur, Installationsquelle, genauer Fehlermeldung und dem fehlgeschlagenen Schritt.

Datei lässt sich nicht öffnen

Wenn beim Öffnen einer Datei ein Fehler auftritt, prüfen Sie:

• Ist die Datei eine gültige .aloxbook-Datei?
• Geben Sie das richtige Passwort ein?
• Wurde die Datei von einer neueren AloxBook-Version erstellt oder aktualisiert? Aktualisieren Sie AloxBook und versuchen Sie es erneut.
• Falls die Datei aus einem synchronisierten Ordner kopiert wurde: Waren Kopieren und Synchronisierung abgeschlossen, nachdem AloxBook geschlossen war?
• Ist die Datei schreibgeschützt? AloxBook kann schreibgeschützte Dateien im Nur-Lesen-Modus öffnen.

Probleme beim CSV-Import

Wenn die CSV-Datei Ihrer Bank nicht korrekt importiert wird, prüfen Sie die Importprofil-Einstellungen: Trennzeichen (Komma, Semikolon, Tab), Datumsformat, Dezimaltrennzeichen und Spaltenzuordnung. Sie können die geparsten Daten vor dem Import in der Vorschau überprüfen.

CSV-Export sieht in Tabellenkalkulationen anders aus

Der CSV-Export verwendet Ihr aktuelles Gebietsschema für Datum, Dezimaltrennzeichen und CSV-Trennzeichen. Die ersten zwei Zeilen enthalten absichtlich den aktiven Filter und die Sortierung, damit die Datei später verständlich bleibt.