Fava-opties

Configureer standaard Fava met gedateerde custom "fava-option"-directieven. Deze instellingen staan los van de kernopties van Beancount.

Deze referentie is uitgevoerd met Beancount 3.2.3, beanquery 0.2.0 en Fava 1.30.16. De matrix beschrijft die standaardrelease. Beancount.io heeft een apart dashboard en backend; de daar zichtbare instellingen bewijzen niet dat elke standaard Fava-functie daar beschikbaar is.

Syntax​

Waarden zijn geciteerde strings, inclusief gehele getallen en booleans. Dit volledige voorbeeld wordt zowel in Beancount als in Fava geparseerd:

; 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"

De datum is verplicht. Fava verwerkt de geladen custom-directieven in datumvolgorde; een later scalaire instelling vervangt een eerdere. Herhaalde collapse-pattern-, import-dirs- en insert-entry-instellingen accumuleren. Invoegregels gebruiken hun datums om een bestemming te kiezen, dus die datums zijn betekenisvol.

Om de voorbeelden lokaal te reproduceren, installeer uv en maak daarna een wegwerpomgeving:

uv venv .venv-fava-docs
uv pip install --python .venv-fava-docs/bin/python 'beancount==3.2.3' 'beanquery==0.2.0' 'fava==1.30.16'
source .venv-fava-docs/bin/activate
bean-check main.beancount
fava main.beancount

Maak eerst main.beancount vanuit het configuratieblok, of gebruik een bestaand grootboek. De bovenstaande shell-opdrachten gebruiken POSIX-paden. bean-check controleert de Beancount-syntax en boekhouding; Fava controleert daarnaast de eigen optienamen en -waarden. Bekijk ook het Fava-foutrapport.

De onderstaande standaardwaarden zijn gelezen uit de geïnstalleerde FavaOptions-dataclass en gecontroleerd tegen de versiegebonden optieparser. "Niet ingesteld" betekent None; een lege verzameling betekent geen geconfigureerde vermeldingen. De kolom waardetype beschrijft de inhoud van de geciteerde string.

Gebruik "true" of "false" voor booleans. De vergelijking is hoofdletterongevoelig: "TRUE" activeert ook een optie. Elke andere string dan een hoofdlettervariant van "true" wordt als onwaar behandeld. De integerparser controleert de integer-syntax, niet een positief bereik; gebruik positieve layoutgroottes en niet-negatieve tellingen.

Weergave & Lokalisatie​

language​

Stelt de interfacetaal in, bijvoorbeeld "en", "de" of "zh_CN". Wanneer dit niet is ingesteld, onderhandelt Fava met de browser. De landcode moet een vertaling hebben die door Fava wordt meegeleverd; een syntactisch geldige taalcodes alleen is onvoldoende.

locale​

Stelt getalnotatie in, onafhankelijk van de interfacetaal, bijvoorbeeld "en_US" of "de_DE". Zonder deze optie gebruikt Fava het niet-gelokaliseerde getalpatroon. Kern option "render_commas" "TRUE" levert de en-fallback. Het erft niet de browsertaal.

Navigatie & Layout​

default-page​

Stelt de bestemming binnen het grootboek in, zoals "balance_sheet/" of "journal/?time=year". Kopieer het deel na de grootboek-slug van een werkende standaard Fava-URL. Voeg geen / toe: rapportpaden zijn relatief aan dat grootboek.

fiscal-year-end​

Stelt de grenzen van fiscale tijdfilters in. Bijvoorbeeld "03-31" beëindigt een fiscaal jaar op 31 maart. Het ondersteunt fiscale jaar- en kwartaalfilters; het verandert geen transactiedatums. Fava accepteert ook maandwaarden boven 12 om een fiscaal jaar te labelen dat in het volgende kalenderjaar eindigt.

indent​

Stelt de postingsinspringing in voor gegenereerde vermeldingen en editoropmaak. Gebruik een positieve integerstring, zoals "4".

currency-column​

Stelt de valuta-uitlijnkolom in bij het opslaan of uitlijnen van postings. Het plaatst ook de verticale richtlijn van de editor. De standaardwaarde is "61".

Contentzichtbaarheid​

show-closed-accounts​

Neemt gesloten accounts op in rapport-accountbomen. Accounts met niet-nul saldi blijven zichtbaar ongeacht deze instelling.

show-accounts-with-zero-transactions​

Neemt accounts zonder transacties op in accountbomen. Het onderdrukt geen account met een niet-nul saldo.

show-accounts-with-zero-balance​

Neemt accounts op waarvan het rapportsaldo nul is. Zet het uit met "false" voor een kortere boom.

collapse-pattern​

Past accountnamen aan om in te klappen in accountbomen. Herhaal het directief voor meerdere patronen. Bijvoorbeeld "^Assets:Investments" klapt dat account en zijn nakomelingen in.

sidebar-show-queries​

Beperkt het aantal opgeslagen query's dat in de zijbalk wordt gekoppeld. "0" verbergt die links. Zie aangepaste links en query's.

show-metadata-indicators​

Toont de kleine metadata-badges in journaals. Zet het op "false" om de badges te verbergen zonder metadata uit het grootboek te verwijderen.

Bestandsbeheer​

default-file​

Kiest het bestand dat de editor initieel opent en de fallback-bestemming voor nieuwe vermeldingen. Een relatief pad wordt opgelost vanuit het bestand dat het directief bevat. Zonder waarde wordt het bevattende bestand geselecteerd. Zonder deze optie is het hoofd-grootboekbestand de fallback. Een bestaand bestand moet ook in het grootboek worden opgenomen om een bewerkbare bron te zijn.

insert-entry​

Plaatst een nieuwe vermelding vóór een overeenkomend custom-directief, in het bestand dat dat directief bevat. De regex past een accountnaam aan vanaf het begin; het zoekt nooit in ruwe bestandsregels. Fava beschouwt transactiepostings van laatste naar eerste. Voor het eerste account met een geschikte overeenkomst kiest het de nieuwste regel gedateerd strikt vóór de nieuwe vermelding. Als niets overeenkomt, wordt toegevoegd aan het standaardbestand. De invoegimplementatie is de autoriteit voor deze regels.

Maak deze drie bestanden in dezelfde directory. main.beancount levert de accounts en inclusies:

; 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 bevat:

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

february.beancount bevat:

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

Start Fava met main.beancount. Voeg deze transacties toe via het transactieformulier; ze zijn invoer voor de invoegoperatie, geen extra bestand om vooraf op te nemen:

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

De eerste twee vermeldingen gaan vóór de januari-regel. De derde gaat vóór de februari-regel. De vierde probeert Assets:Cash, vindt geen overeenkomst en gebruikt dan de Expenses:Food-regel in het hoofdbestand. De vijfde heeft geen overeenkomend account en wordt toegevoegd aan main.beancount. Het opslaan van een batch werkt regelnummers bij terwijl vermeldingen worden ingevoegd.

auto-reload​

Herlaadt de pagina automatisch wanneer Fava een externe bronwijziging detecteert. Wanneer onwaar, biedt Fava een herlaadmelding. Wijzigingen via Fava zelf triggeren al een herlading.

use-external-editor​

Opent bronlinks via het beancount://-URL-schema. Installeer een handler op de computer die de browser gebruikt en zorg dat deze toegang heeft tot de grootboekbestanden. Dit is geen automatische verbinding met bestanden op een gehoste server.

import-config​

Wijst naar een Python-importerconfiguratie. Dit is een integratie-instelling: maak de configuratie en installeer de importerafhankelijkheden voordat u het Import-rapport gebruikt. De drie vastgezette pakketten hierboven leveren geen bankimporterconfiguratie.

import-dirs​

Voegt een directory toe om te scannen op importkandidaten. Herhaal het directief om directories toe te voegen. Gebruik echte toegankelijke directories; het instellen van de optie creëert ze niet.

Financiële weergave​

unrealized​

Geen standaard Fava 1.30.16-optie. Fava rapporteert Unknown option gevolgd door de naam in backticks als u het toevoegt. Gebruik het niet om standaard ongerealiseerde-winst-accounts te configureren.

De Beancount.io-bronsnapshot die op 2026-09-07 is beoordeeld, exposeert wel een apart stringveld genaamd unrealized, met standaard "Unrealized", in de backend-optieparser en de dashboardinstellingentabel. Dat verifieert dat het veld daar bestaat. Het stelt niet vast dat het wijzigen ervan Income:Unrealized of Expenses:Unrealized creëert, of dat een specifieke implementatie deze snapshot draait.

invert-income-liabilities-equity​

Draait de weergegeven tekens van Inkomsten, Verplichtingen en Eigen vermogen om in de resultatenrekening en balans. Uitgaven behouden hun tekens. Journaalvermeldingen, accountjournaals en opgeslagen postings blijven ongewijzigd.

conversion-currencies​

Vervangt de conversie-dropdownkeuzes door een door spaties gescheiden lijst in één string:

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

Het herhalen van deze optie vervangt de vorige lijst. Wanneer niet ingesteld, biedt Fava operationele valuta's plus grondstoffen die het herkent als ISO 4217-valuta's.

account-journal-include-children​

Neemt standaard kind-accountvermeldingen op in het journaal van een account. Zet het op "false" om te starten met alleen dat account.

invert-gains-losses-colors​

Keert de kleuren om die worden gebruikt voor ongerealiseerde winsten en verliezen in marktwaarde-balans en proefbalansweergaven. Het verandert kleuren, niet bedragen of accountnamen.

Monitoring​

uptodate-indicator-grey-lookback-days​

Regelt de terugkijkperiode van de grijze actualiteitsindicator. Schakel accountindicatoren in met fava-uptodate-indication: TRUE op het open-directief van het account; zie het UI-metadatavoorbeeld.

upcoming-events​

Regelt het aantal meldingen in de zijbalk voor aankomende gebeurtenissen binnen het opgegeven aantal dagen. "0" schakelt de telling uit.

Aanbevolen configuratie​

Deze volledige configuratie is een startpunt voor de bovenstaande standaardomgeving. Het verandert weergave-instellingen zonder plugins te laden of extra bestanden te vereisen:

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"

Uw huidige opties bekijken​

In standaard Fava opent u de Help → Opties-pagina voor de referentie van de geïnstalleerde release en controleert u Fouten na het wijzigen van een directief. De officiële 1.30.16-optieshelp legt de instellingen uit.

In het Beancount.io-dashboard opent u de instellingenpagina van een grootboek. De Fava-opties-tabel toont de subset die door de backend wordt geretourneerd. Deze UI is geverifieerd in de productsource-snapshot, niet via een geverifieerde productiesessie. Een weergegeven veld impliceert niet dat het gehoste dashboard de editor, imports of URL-routes van standaard Fava implementeert.

Zie ook​

• Optiesconfiguratie — De kern option-directieven van Beancount.
• UI-functies — Standaard Fava-workflows en gehoste compatibiliteit.