Fava-Optionsreferenz für die Beancount-Weboberfläche

Konfigurieren Sie stock Fava mit datierten custom "fava-option"-Direktiven. Diese Einstellungen sind von den Beancount-Core-Optionen getrennt.

Diese Referenz wurde mit Beancount 3.2.3, beanquery 0.2.0 und Fava 1.30.16 ausgeführt. Die Matrix beschreibt diese stock Version. Beancount.io hat ein separates Dashboard und Backend; dessen angezeigte Einstellungen beweisen nicht, dass jede stock Fava-Funktion dort verfügbar ist.

Syntax​

Werte sind zitierte Strings, einschließlich Ganzzahlen und Booleans. Dieses vollständige Beispiel wird sowohl von Beancount als auch von Fava geparst:

; Minimal Fava configuration
option "operating_currency" "USD"
2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "default-page" "income_statement/"
2000-01-01 custom "fava-option" "indent" "2"
2000-01-01 custom "fava-option" "show-closed-accounts" "false"

Das Datum ist erforderlich. Fava verarbeitet die geladenen benutzerdefinierten Direktiven in Datumsreihenfolge; eine spätere skalare Einstellung ersetzt eine frühere. Wiederholte collapse-pattern, import-dirs und insert-entry Einstellungen akkumulieren sich. Einfügeregeln verwenden deren Daten, um ein Ziel zu wählen, daher sind diese Daten aussagekräftig.

Um die Beispiele lokal zu reproduzieren, installieren Sie uv und erstellen Sie dann eine temporäre Umgebung:

uv venv .venv-fava-docs
uv pip install --python .venv-fava-docs/bin/python 'fava==1.30.16'
uv tool install beancount-io
source .venv-fava-docs/bin/activate
bea --file main.beancount check
fava main.beancount

Erstellen Sie zuerst main.beancount aus dem Konfigurationsblock oder verwenden Sie ein bestehendes Ledger. Die obigen Shell-Befehle verwenden POSIX-Pfade. bea check prüft Beancount-Syntax und -Buchführung; Fava überprüft zusätzlich seine eigenen Optionsnamen und -werte. Überprüfen Sie auch Favas Fehlerbericht.

Die untenstehenden Standardwerte wurden aus der installierten FavaOptions-Datenklasse gelesen und mit dem versionierten Optionsparser abgeglichen. „Nicht gesetzt“ bedeutet None; eine leere Sammlung bedeutet keine konfigurierten Einträge. Die Spalte Wert-Typ beschreibt den Inhalt des zitierten Strings.

Verwenden Sie "true" oder "false" für Booleans. Der Vergleich ist nicht groß-/klein-geschrieben: "TRUE" aktiviert ebenfalls eine Option. Jeder andere String als eine Fallvariante von "true" wird als false behandelt. Sein Ganzzahlparser prüft die Ganzzahlsyntax, nicht einen positiven Bereich; verwenden Sie positive Layoutgrößen und nicht negative Zählwerte.

Anzeige & Lokalisierung​

language​

Legt die Schnittstellenübersetzung fest, zum Beispiel "en", "de" oder "zh_CN". Wenn nicht gesetzt, verhandelt Fava mit dem Browser. Die Locale muss eine von Fava gelieferte Übersetzung enthalten; ein syntaktisch gültiger Sprachcode allein reicht nicht aus.

locale​

Legt die Zahlenformatierung unabhängig von der Schnittstellensprache fest, zum Beispiel "en_US" oder "de_DE". Ohne diese Option verwendet Fava sein unlokalisiertes Zahlenmuster. Kern option "render_commas" "TRUE" liefert den en-Fallback. Er erbt nicht die Browsersprache.

Navigation & Layout​

default-page​

Legt das Ziel innerhalb des Hauptbuchs fest, zum Beispiel "balance_sheet/" oder "journal/?time=year". Kopieren Sie den Teil nach dem Hauptbuch-Slug aus einer funktionierenden Fava-URL. Fügen Sie / nicht voran: Berichtspfade sind relativ zu diesem Hauptbuch.

fiscal-year-end​

Legt die Grenzen für den fiskalischen Zeitfilter fest. Zum Beispiel endet "03-31" ein Geschäftsjahr am 31. März. Es unterstützt Filter für Geschäftsjahr und Quartal; es ändert nicht die Buchungsdaten. Fava akzeptiert auch Monatswerte über 12, um ein Geschäftsjahr zu kennzeichnen, das im nächsten Kalenderjahr endet.

indent​

Legt die Einrückung der Buchungen für generierte Einträge und die Formatierung des Editors fest. Verwenden Sie eine positive Ganzzahl als Zeichenkette, zum Beispiel "4".

currency-column​

Legt die Spalte für die Währungsausrichtung beim Speichern oder Ausrichten von Buchungen fest. Es positioniert auch die vertikale Führungslinie des Editors. Der Standardwert ist "61".

Inhalts-Sichtbarkeit​

show-closed-accounts​

Bezieht geschlossene Konten in Berichts-Kontobäume ein. Konten mit einem ungleich Null liegenden Saldo bleiben unabhängig von dieser Einstellung sichtbar.

show-accounts-with-zero-transactions​

Bezieht Konten ohne Buchungen in Kontobäume ein. Es unterdrückt kein Konto, das einen ungleich Null liegenden Saldo hat.

show-accounts-with-zero-balance​

Bezieht Konten ein, deren Berichtssaldo null ist. Schalten Sie es mit "false" aus, um einen kürzeren Baum zu erhalten.

collapse-pattern​

Passt Kontonamen zum Zusammenklappen in Kontobäumen an. Wiederholen Sie die Direktive für mehrere Muster. Zum Beispiel klappt "^Assets:Investments" dieses Konto und seine Nachfolger zusammen.

sidebar-show-queries​

Begrenzt die Anzahl der gespeicherten Abfragen, die in der Seitenleiste verlinkt sind. "0" blendet diese Links aus. Siehe benutzerdefinierte Links und Abfragen.

show-metadata-indicators​

Zeigt die kleinen Metadaten-Abzeichen in Journalen an. Setzen Sie es auf "false", um die Abzeichen auszublenden, ohne Metadaten aus dem Hauptbuch zu entfernen.

Dateiverwaltung​

default-file​

Wählt die Datei aus, die der Editor zunächst öffnet, und das Fallback-Ziel für neue Einträge. Ein relativer Pfad wird relativ zur Datei mit der Direktive aufgelöst. Ohne Wert wird die enthaltene Datei ausgewählt. Ohne diese Option ist die Hauptbuch-Datei das Fallback. Eine vorhandene Datei muss auch im Hauptbuch enthalten sein, um eine bearbeitbare Quelle zu sein.

insert-entry​

Platziert einen neuen Eintrag vor einer passenden benutzerdefinierten Direktive, in der Datei, die diese Direktive enthält. Sein Regex stimmt mit einem Kontonamen von Anfang an überein; es durchsucht niemals rohe Dateizeilen. Fava betrachtet Buchungsposten von Transaktionen von hinten nach vorne. Für das erste Konto mit einem geeigneten Treffer wählt es die neueste Regel, die strikt vor dem neuen Eintrag datiert ist. Wenn keine passt, wird es an die Standarddatei angehängt. Die Einfügeimplementierung ist die Autorität für diese Regeln.

Erstellen Sie diese drei Dateien im gleichen Verzeichnis. main.beancount liefert die Konten und umfasst:

; main.beancount
option "title" "Insertion Demo"
option "operating_currency" "USD"
include "january.beancount"
include "february.beancount"
2000-01-01 open Assets:Checking USD
2000-01-01 open Assets:Cash USD
2000-01-01 open Assets:Wallet USD
2000-01-01 open Expenses:Food USD
2000-01-01 custom "fava-option" "default-file"
2024-01-01 custom "fava-option" "insert-entry" "^Expenses:Food$"

january.beancount enthält:

; january.beancount
2024-01-01 custom "fava-option" "insert-entry" "^Assets:Checking$"

february.beancount enthält:

; february.beancount
2024-02-01 custom "fava-option" "insert-entry" "^Assets:Checking$"

Starten Sie Fava mit main.beancount. Fügen Sie diese Buchungen über das Buchungsformular hinzu; sie sind Eingaben für die Einfügeoperation, nicht eine zusätzliche Datei, die zuvor eingebunden wird:

2024-01-15 * "January groceries"
  Expenses:Food       10.00 USD
  Assets:Checking    -10.00 USD
 
2024-02-01 * "Same-day boundary"
  Expenses:Food       20.00 USD
  Assets:Checking    -20.00 USD
 
2024-02-15 * "February groceries"
  Expenses:Food       30.00 USD
  Assets:Checking    -30.00 USD
 
2024-02-16 * "Cash groceries"
  Expenses:Food       40.00 USD
  Assets:Cash        -40.00 USD
 
2024-02-17 * "Unmatched cash transfer"
  Assets:Cash         50.00 USD
  Assets:Wallet      -50.00 USD

Die ersten zwei Einträge kommen vor die Januar-Regel. Der dritte kommt vor die Februar-Regel. Der vierte versucht Assets:Cash, findet keinen Treffer und verwendet dann die Expenses:Food-Regel in der Hauptdatei. Der fünfte hat kein passendes Konto und wird an main.beancount angehängt. Das Speichern eines Batches aktualisiert die Regelzeilennummern, während Einträge eingefügt werden.

auto-reload​

Lädt die Seite automatisch neu, wenn Fava eine externe Änderungsquelle erkennt. Wenn falsch, bietet Fava eine Benachrichtigung zum Neuladen an. Änderungen, die direkt über Fava gemacht werden, führen bereits zu einem Neuladen.

use-external-editor​

Öffnet Quelllinks über das beancount://-URL-Schema. Installieren Sie einen Handler auf dem Computer, auf dem der Browser läuft, und stellen Sie sicher, dass er Zugriff auf die Kontobuchdateien hat. Dies ist keine automatische Verbindung zu Dateien auf einem gehosteten Server.

import-config​

Verweist auf eine Python-Importer-Konfiguration. Dies ist eine Integrations-Einstellung: Erstellen Sie die Konfiguration und installieren Sie deren Importer-Abhängigkeiten, bevor Sie den Importbericht verwenden. Die drei oben angehefteten Pakete bieten keine Bankimporter-Konfiguration.

import-dirs​

Fügt ein Verzeichnis hinzu, das auf Importkandidaten durchsucht werden soll. Wiederholen Sie die Direktive, um weitere Verzeichnisse hinzuzufügen. Verwenden Sie echte zugängliche Verzeichnisse; durch das Setzen der Option werden sie nicht erstellt.

Finanzanzeige​

unrealized​

Keine Standardoption von Fava 1.30.16. Fava meldet Unknown option gefolgt vom Namen in Backticks, wenn Sie es hinzufügen. Verwenden Sie es nicht, um Standardkonten für nicht realisierte Gewinne zu konfigurieren.

Der am 07.09.2026 überprüfte Beancount.io-Quellcode-Snapshot enthält im Backend-Optionsparser und der Dashboard-Einstellungstabelle ein separates Zeichenkettenfeld namens unrealized mit dem Standardwert "Unrealized". Das bestätigt, dass das Feld dort existiert. Es beweist jedoch nicht, dass eine Änderung dieses Feldes Income:Unrealized oder Expenses:Unrealized erzeugt oder dass eine bestimmte Bereitstellung diesen Snapshot verwendet.

invert-income-liabilities-equity​

Kehrt die angezeigten Vorzeichen von Einkommen, Verbindlichkeiten und Eigenkapital in der Gewinn- und Verlustrechnung sowie Bilanz um. Aufwendungen behalten ihr Vorzeichen. Buchungssätze, Kontentagebücher und gespeicherte Buchungen bleiben unverändert.

conversion-currencies​

Ersetzt die Auswahlmöglichkeiten im Umrechnungs-Dropdown durch eine durch Leerzeichen getrennte Liste in einem String:

; Conversion dropdown
2000-01-01 custom "fava-option" "conversion-currencies" "USD EUR"

Mehrfaches Setzen dieser Option ersetzt die vorherige Liste. Wenn sie nicht gesetzt ist, bietet Fava Betriebsgesellschaftswährungen sowie Rohstoffe an, die es als ISO 4217-Währungen erkennt.

account-journal-include-children​

Bezieht standardmäßig Buchungen aus Unterkonten in das Kontotagebuch ein. Setze es auf "false", um nur mit diesem Konto zu beginnen.

invert-gains-losses-colors​

Vertauscht die Farben für unrealisierte Gewinne und Verluste in Bilanzansichten zum Marktwert und in Probe-Salden. Es ändert die Farben, nicht Beträge oder Kontonamen.

Überwachung​

uptodate-indicator-grey-lookback-days​

Steuert den Beobachtungszeitraum des grauen Frischeindikators. Aktivieren Sie Kontenindikatoren mit fava-uptodate-indication: TRUE in der open-Direktive des Kontos; siehe das Beispiel für UI-Metadaten.

upcoming-events​

Steuert die Benachrichtigungsanzahl in der Seitenleiste für bevorstehende Ereignisse innerhalb der angegebenen Tage. "0" deaktiviert die Zählung.

Empfohlene Konfiguration​

Diese vollständige Konfiguration ist ein Ausgangspunkt für die oben beschriebene Standardumgebung. Sie ändert Anzeigeeinstellungen, ohne Plugins zu laden oder zusätzliche Dateien zu benötigen:

option "operating_currency" "USD"
2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "locale" "en_US"
2000-01-01 custom "fava-option" "default-page" "income_statement/"
2000-01-01 custom "fava-option" "fiscal-year-end" "12-31"
2000-01-01 custom "fava-option" "indent" "2"
2000-01-01 custom "fava-option" "currency-column" "61"
2000-01-01 custom "fava-option" "show-closed-accounts" "false"
2000-01-01 custom "fava-option" "show-accounts-with-zero-transactions" "true"
2000-01-01 custom "fava-option" "show-accounts-with-zero-balance" "false"
2000-01-01 custom "fava-option" "show-metadata-indicators" "true"
2000-01-01 custom "fava-option" "collapse-pattern" "^Assets:Investments"
2000-01-01 custom "fava-option" "sidebar-show-queries" "5"
2000-01-01 custom "fava-option" "auto-reload" "false"
2000-01-01 custom "fava-option" "use-external-editor" "false"
2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "false"
2000-01-01 custom "fava-option" "invert-gains-losses-colors" "false"
2000-01-01 custom "fava-option" "conversion-currencies" "USD EUR"
2000-01-01 custom "fava-option" "account-journal-include-children" "true"
2000-01-01 custom "fava-option" "upcoming-events" "7"
2000-01-01 custom "fava-option" "uptodate-indicator-grey-lookback-days" "60"

Anzeige Ihrer aktuellen Optionen​

Öffnen Sie in der Standardversion von Fava die Seite Hilfe → Optionen für die Referenz der installierten Version und prüfen Sie Fehler nach dem Ändern einer Direktive. Die offizielle Hilfe zu Optionen Version 1.30.16 erklärt die Einstellungen.

Öffnen Sie im Beancount.io-Dashboard die Einstellungsseite eines Hauptbuchs. Die Fava-Options-Tabelle zeigt das vom Backend zurückgegebene Teilergebnis. Diese UI wurde im Produktsnapshot überprüft, jedoch nicht durch eine authentifizierte Produktionssitzung. Ein angezeigtes Feld bedeutet nicht, dass das gehostete Dashboard den Standard-Fava-Editor, Importe oder URL-Routen unterstützt.

Siehe auch​

• Optionskonfiguration — Die Kern-option-Direktiven von Beancount.
• UI-Funktionen — Standard-Workflows von Fava und gehostete Kompatibilität.