Het Beancount-ecosysteem: een uitgebreide analyse

Actueel per 15-09-2026.

Voor een onderhouden catalogus van importeurs, plugins, editors en prijsbronnen, begin je bij Awesome Beancount. Voor praktische community-workflows, zie de community showcase. Voor de gehoste CLI die check, query, import en rapporten omvat, zie de Beancount CLI-referentie; Fava-gerichte analyses vind je in Oplossingen: analyses.

Kernfunctionaliteit en filosofie van Beancount​

Beancount is een open-source systeem voor dubbel boekhouden dat platte tekstbestanden gebruikt om transacties vast te leggen. In de kern behandelt Beancount je grootboek als een dataset die wordt gedefinieerd door een eenvoudige, strikte grammatica. Elke financiële gebeurtenis (transacties, het openen van rekeningen, grondstofprijzen, enz.) is een richtlijn in een tekstbestand, die Beancount parseert tot een in-memory database van boekingen. Dit ontwerp handhaaft het principe van dubbel boekhouden: elke transactie moet debets en credits over rekeningen in evenwicht brengen. Het resultaat is een zeer transparant en controleerbaar grootboek dat je eenvoudig onder versiebeheer kunt plaatsen, kunt inspecteren en kunt doorzoeken.

Filosofie – correctheid en minimalisme: Het ontwerp van Beancount geeft prioriteit aan gegevensintegriteit en eenvoud. De maker, Martin Blais, beschrijft Beancount als “pessimistisch” in de veronderstelling dat de gebruiker fouten zal maken en daarom extra controles en beperkingen oplegt. Beancount staat je bijvoorbeeld niet toe om activa te verwijderen die nooit zijn toegevoegd (waardoor negatieve aandelenposities of kassaldi worden voorkomen) en kan afdwingen dat elke rekening vóór gebruik wordt geopend. Het mist Ledger’s concept van “virtuele” of automatisch gebalanceerde boekingen – een bewuste keuze om volledig gebalanceerde boekingen af te dwingen. Beancount gaat effectief “hardcore” op correctheid met meer kruiscontroles dan basis dubbel boekhouden biedt. Deze voorzichtige aanpak spreekt gebruikers aan die “zichzelf niet te veel vertrouwen” en willen dat de software hun fouten opvangt.

Minimale opties, maximale consistentie: In tegenstelling tot Ledger’s overvloed aan commandoregelvlaggen en afstelopties, kiest Beancount voor minimalisme. Er zijn zeer weinig globale opties en geen enkele die de transactiesemantiek buiten het grootboekbestand verandert. Alle configuratie die de boekhouding beïnvloedt (zoals methoden voor kostprijsbasis van grondstoffen of boekingsaannames) gebeurt in het bestand via richtlijnen of plugins, waardoor het laden van hetzelfde bestand altijd dezelfde resultaten oplevert, ongeacht hoe rapporten worden gegenereerd. Dit ontwerp vermijdt de complexiteit van Ledger’s vele knoppen en de subtiele interacties daartussen. De filosofie van Beancount is dat een boekhoudhulpmiddel een stabiele, deterministische pijplijn moet zijn van invoerbestand naar rapporten. Het bereikt dit door het grootboek te behandelen als een geordende stroom van richtlijnen die programmatisch in volgorde kunnen worden verwerkt. Zelfs zaken die Ledger als speciale syntaxis behandelt (zoals openingssaldi of prijsverklaringen) zijn eersteklas richtlijnen in het gegevensmodel van Beancount, wat het systeem zeer uitbreidbaar maakt.

Uitbreidbaarheid via plugins en querytaal: Beancount is geïmplementeerd in Python en biedt hooks om aangepaste logica in de verwerkingspijplijn te injecteren. Gebruikers kunnen plugins in Python schrijven die op de transactiestroom werken (bijvoorbeeld om een aangepaste regel af te dwingen of automatische boekingen te genereren). Deze plugins worden uitgevoerd terwijl het bestand wordt verwerkt, waardoor de kernfunctionaliteit van Beancount effectief wordt uitgebreid zonder de broncode te wijzigen. Beancount bevat ook een krachtige querytaal (geïnspireerd door SQL) om het grootboek in stukken te snijden en te analyseren. De bean-query tool behandelt het geparsede grootboek als een database en laat je analytische query’s uitvoeren – bijvoorbeeld het optellen van uitgaven per categorie of het extraheren van alle transacties voor een bepaalde begunstigde. In Beancount 3.x is deze querymogelijkheid verplaatst naar een losstaand beanquery-pakket, maar vanuit gebruikersperspectief biedt het nog steeds flexibele rapportage via SQL-achtige query’s.

Platte tekst en versiebeheer: Als hulpmiddel voor boekhouding in platte tekst benadrukt Beancount gebruikerscontrole en levensduur van gegevens. Het grootboek is simpelweg een .beancount-tekstbestand dat je in elke teksteditor kunt bewerken. Dit betekent dat je volledige financiële geschiedenis in een door mensen leesbare vorm wordt opgeslagen en dat je het in Git of een ander versiebeheersysteem kunt plaatsen om wijzigingen in de loop van de tijd te volgen. Gebruikers houden hun Beancount-bestand vaak onder versiebeheer om een audit trail van elke bewerking te behouden (met commit-berichten die wijzigingen beschrijven). Deze aanpak sluit aan bij de filosofie van Beancount dat boekhoudgegevens, vooral voor persoonlijke of kleine bedrijfsfinanciën, transparant en “toekomstbestendig” moeten zijn – niet opgesloten in een propriëtaire database. In Martin Blais’ eigen woorden is Beancount een “arbeid van liefde” die is gebouwd om eenvoudig, duurzaam en gratis te zijn voor de community. Het werd voor het eerst ontwikkeld rond 2007 en is geëvolueerd door grote herschrijvingen (v1 naar v2, en nu v3 in 2024) om het ontwerp te verfijnen terwijl de kernfilosofie van minimalisme en correctheid behouden blijft.

Hulpmiddelen, plugins en extensies in het Beancount-ecosysteem​

Het Beancount-ecosysteem heeft een rijke set aan hulpmiddelen, plugins en extensies ontwikkeld die de kernfunctionaliteit van het grootboek verbeteren. Deze dekken het importeren van gegevens, het bewerken van grootboeken, het bekijken van rapporten en het toevoegen van gespecialiseerde boekhoudfuncties. Hieronder vind je een overzicht van de belangrijkste componenten en add-ons in de Beancount-wereld:

Hulpprogramma’s voor gegevensimport (Importeurs)​

Een van de belangrijkste behoeften voor praktisch gebruik is het importeren van transacties van banken, creditcards en andere financiële instellingen. Beancount biedt een importraamwerk en door de community bijgedragen importscripts voor dit doel. In Beancount 2.x werd de ingebouwde module beancount.ingest (met opdrachten zoals bean-extract en bean-identify) gebruikt om importeur-plugins in Python te definiëren en toe te passen op gedownloade afschriften. In Beancount 3.x is dit vervangen door een extern project genaamd Beangulp. Beangulp is een speciaal importeursraamwerk dat is voortgekomen uit beancount.ingest en nu de aanbevolen manier is om transactie-import voor Beancount 3.0 te automatiseren. Het maakt het mogelijk om Python-scripts of commandoregelhulpmiddelen te schrijven die externe bestanden (zoals CSV- of PDF-afschriften) lezen en Beancount-boekingen uitvoeren. Deze nieuwe aanpak ontkoppelt de importlogica van de Beancount-kern – de oude bean-extract-opdracht is bijvoorbeeld verwijderd in v3, en in plaats daarvan produceren je importscripts zelf transacties via de CLI-interface van Beangulp.

Er bestaan tientallen ** kant-en-klare importeurs** voor verschillende banken en formaten, bijgedragen door de community. Er zijn importscripts voor instellingen over de hele wereld – van Alipay en WeChat Pay in China, tot verschillende Europese banken (Commerzbank, ING, ABN AMRO, enz.), tot Amerikaanse banken zoals Chase en Amex. Veel hiervan zijn verzameld in openbare repositories (vaak op GitHub) of in pakketten zoals beancount-importers. Het Tarioch Beancount Tools-project (tariochbctools) biedt bijvoorbeeld importeurs voor Zwitserse en Britse banken en behandelt zelfs crypto-transactie-import. Een ander voorbeeld is Lazy Beancount, dat een set veelgebruikte importeurs bundelt (voor Wise, Monzo, Revolut, IBKR, enz.) en een op Docker gebaseerde opzet biedt voor eenvoudige automatisering. Welke bank of financiële dienst je ook gebruikt, de kans is groot dat iemand er een Beancount-importeur voor heeft geschreven – of je kunt er zelf een schrijven met behulp van het Beangulp-raamwerk. De flexibiliteit van Python betekent dat importeurs het parseren van CSV/Excel-bestanden, OFX/QIF-downloads of zelfs het scrapen van API’s kunnen afhandelen en vervolgens transacties in gestandaardiseerd Beancount-formaat kunnen uitvoeren.

Bewerken en editorintegratie​

Omdat Beancount-grootboeken slechts tekst zijn, gebruiken gebruikers vaak hun favoriete teksteditors of IDE’s om ze te onderhouden. Het ecosysteem biedt editorondersteuningsplugins om deze ervaring soepeler te maken. Er zijn extensies voor veel populaire editors die syntaxishooglichting, automatische aanvulling van rekeningnamen en realtime foutcontrole toevoegen:

• Emacs Beancount-Mode: Een Emacs-majormode (beancount-mode) is beschikbaar om .beancount-bestanden te bewerken, met functies zoals syntaxiskleuring en integratie met de checker van Beancount. Het kan zelfs bean-check op de achtergrond uitvoeren, zodat fouten in het grootboek (zoals een ongebalanceerde transactie) worden gemarkeerd terwijl je bewerkt.
• VS Code-extensie: Een Beancount-extensie op de VSCode Marketplace biedt vergelijkbare gemakken voor Visual Studio Code-gebruikers. Het ondersteunt syntaxishooglichting, uitlijning van bedragen, automatische aanvulling voor rekeningen/begunstigden en zelfs directe saldochecks wanneer je het bestand opslaat. Het kan ook integreren met Fava, zodat je de Fava-webinterface vanuit VSCode kunt starten.
• Plugins of modi bestaan ook voor Vim, Atom en andere editors. Er is bijvoorbeeld een Tree-sitter-grammatica voor Beancount, die syntaxishooglichting in moderne editors aandrijft en zelfs is overgenomen in de webgebaseerde editorcomponent van Fava. Kortom, wat je bewerkingsomgeving ook is, de community heeft waarschijnlijk een plugin geleverd om het bewerken van Beancount-bestanden handig en foutloos te maken.

Voor snelle invoer van transacties buiten traditionele editors zijn er ook hulpmiddelen zoals Bean-add en mobiele apps. Bean-add is een commandoregelhulpmiddel waarmee je een nieuwe transactie kunt toevoegen via een prompt of one-liner, met suggesties voor datum en rekening. Mobiel biedt een project genaamd Beancount Mobile een eenvoudige interface om onderweg transacties in te voeren (bijvoorbeeld het vastleggen van een contante aankoop vanaf je telefoon). Daarnaast bestaat er een Beancount Telegram Bot om transacties via berichten vast te leggen – je kunt een bericht met transactiegegevens sturen en de bot formatteert dit in je grootboekbestand.

Web-frontends en visualisatiehulpmiddelen​

(Fava) Fava’s webinterface biedt een interactief dashboard voor Beancount, met rapporten zoals een resultatenrekening met visualisaties (hier weergegeven als een treemap van uitgaven per categorie) naast tabellen met rekeningen en saldi.

Het belangrijkste frontend voor Beancount is Fava, een moderne webinterface. Fava draait als een lokale webapp die je Beancount-bestand leest en een rijke interactieve ervaring in je browser produceert. Het biedt een complete reeks rapporten: balans, resultatenrekening, vermogen in de loop van de tijd, portefeuilleposities, prestatiegrafieken, budgetten en meer – allemaal out of the box. Gebruikers noemen Fava vaak als een belangrijke reden om voor Beancount te kiezen boven andere boekhoudhulpmiddelen in platte tekst. Met een enkele opdracht (fava ledger.beancount) kun je je financiën verkennen met grafieken en tabellen in plaats van tekst. Fava ondersteunt functies zoals: inzoomen op rekeningen, filteren van transacties op begunstigde of tag, een query-editor (zodat je Beancount-query’s kunt uitvoeren en resultaten in de browser kunt zien), en zelfs een geïntegreerde webgebaseerde editor voor je grootboek. Het is zeer bruikbaar en maakt boekhouding in platte tekst toegankelijk voor degenen die de voorkeur geven aan visuele interfaces.

Onder de motorkap is Fava geschreven in Python (Flask op de backend) en JavaScript (Svelte op de frontend). Het heeft zijn eigen releasecyclus en wordt actief onderhouden. Opmerkelijk is dat Fava gelijke tred heeft gehouden met de ontwikkeling van Beancount – Fava 1.30 voegde bijvoorbeeld ondersteuning voor Beancount v3 toe, waarbij intern wordt overgeschakeld op de nieuwe beanquery- en beangulp-pakketten. Vanaf Fava 1.30.13 (2026-05-19) (changelog) is de ondersteuning voor Beancount 2 volledig vervallen — de huidige PyPI-Fava (1.30.16 per 2026-09-15) verwacht een Beancount 3-grootboek en op beangulp gebaseerde importeurs. Fava’s focus op bruikbaarheid omvat mooie details zoals automatische aanvulling in de webeditor en een strakke gebruikersinterface met donkere modus en responsieve grafieken. Er is ook een spin-off genaamd Fava-GTK, die Fava verpakt in een desktopapplicatie voor GNOME/Linux-gebruikers die de voorkeur geven aan een native app-gevoel.

Naast Fava zijn er andere visualisatie- en analyseopties. Omdat Beancount-gegevens kunnen worden geëxporteerd of opgevraagd als tabellen, gebruiken gebruikers vaak hulpmiddelen zoals Jupyter-notebooks of Pandas voor aangepaste analyses. Een gebruiker beschrijft bijvoorbeeld hoe hij gegevens uit Beancount via de query-interface in een Pandas DataFrame haalt om een aangepast rapport voor te bereiden. Er zijn ook door de community bijgedragen scripts voor specifieke rapporten – bijvoorbeeld een hulpmiddel voor portefeuilleallocatieanalyse of een procescontrolediagram voor uitgaven versus vermogen. Voor de meeste mensen biedt Fava echter meer dan voldoende rapportagemogelijkheden zonder dat je code hoeft te schrijven. Het ondersteunt zelfs extensies: je kunt Python-bestanden toevoegen die nieuwe rapportpagina’s of grafieken aan Fava toevoegen. Een opmerkelijke extensie is fava-envelope voor envelopbudgettering binnen Fava. Over het algemeen fungeert Fava als het centrale visualisatiecentrum van het Beancount-ecosysteem.

Commandoregelhulpprogramma’s en scripts​

Beancount wordt geleverd met verschillende CLI-hulpmiddelen (vooral in de oudere v2-tak, waarvan sommige in v3 zijn teruggebracht). Deze hulpmiddelen werken op je grootboekbestand om het te controleren of specifieke rapporten in tekst of HTML te genereren:

• bean-check: een validator die controleert op syntaxis- of boekhoudfouten in het bestand. Het uitvoeren van bean-check myfile.beancount waarschuwt je voor eventuele onevenwichtigheden, ontbrekende rekeningen of andere problemen en geeft niets uit als het bestand foutloos is.
• bean-format: een formatter die je grootboek opruimt door getallen in nette kolommen uit te lijnen, vergelijkbaar met het uitvoeren van een codeformatter op broncode. Dit helpt om het bestand schoon en leesbaar te houden.
• bean-query: een interactieve shell of batchtool om Beancount’s querytaal op je grootboek uit te voeren. Je kunt het gebruiken om aangepaste tabelrapporten te produceren (bijv. bean-query myfile.beancount "SELECT account, sum(amount) WHERE ...").
• bean-report: een veelzijdige rapportgenerator (in v2) die vooraf gedefinieerde rapporten (balans, resultatenrekening, proefbalans, enz.) naar de console of naar bestanden kan uitvoeren. Bijvoorbeeld, bean-report file.beancount balances zou rekeningaldi afdrukken. (In de praktijk zijn veel van deze tekstrapporten vervangen door de mooiere presentatie van Fava.)
• bean-web / bean-bake: een oudere webinterface die de rapporten op localhost serveerde of “bakte” als statische HTML-bestanden. Deze werden meestal gebruikt voordat Fava populair werd; bean-web bood een basiswebweergave van dezelfde rapporten die bean-report kon genereren. In Beancount 3 is bean-web verwijderd (aangezien Fava nu de aanbevolen web-frontend is, die een superieure ervaring biedt).
• bean-example: een hulpprogramma om een voorbeeldgrootboekbestand te genereren (nuttig voor nieuwkomers om een sjabloon van Beancount-boekingen te zien).
• bean-doctor: een debugtool die problemen in je grootboek of omgeving kan diagnosticeren.

Het is vermeldenswaard dat vanaf Beancount v3 veel van deze hulpmiddelen uit het kernproject zijn verplaatst. Het kernpakket van Beancount werd gestroomlijnd en hulpmiddelen zoals de query-engine en importeurs werden opgesplitst in afzonderlijke pakketten (beanquery, beangulp, enz.) voor eenvoudiger onderhoud. De functionaliteit van bean-query wordt bijvoorbeeld nu geleverd door het beanquery-hulpmiddel dat afzonderlijk wordt geïnstalleerd. Vanuit gebruikersperspectief blijft de functionaliteit beschikbaar; het is gewoon gemodulariseerd. De Arch Linux-community merkte deze wijziging op bij het bijwerken van Fava: het Fava-pakket voegde afhankelijkheden toe aan beanquery en beangulp om Beancount 3.x te ondersteunen. Deze modulaire aanpak stelt ook anderen in de community in staat om onafhankelijker bij te dragen aan deze hulptools dan aan de releasecyclus van Beancount.

Beancount-plugins en -extensies​

Een opvallende kracht van het Beancount-ecosysteem is het pluginsysteem. Door een plugin "module.name"-regel aan je Beancount-bestand toe te voegen, kun je aangepaste Python-logica opnemen die tijdens de grootboekverwerking wordt uitgevoerd. De community heeft veel plugins gemaakt om de mogelijkheden van Beancount uit te breiden:

• Gegevenskwaliteit en -regels: Voorbeelden zijn beancount-balexpr waarmee je vergelijkingen met meerdere rekeningen kunt beweren (bijv. Activa A + Activa B = Schuld X), en beancount-checkclosed dat automatisch saldo-asserties invoegt wanneer je een rekening sluit om ervoor te zorgen dat deze op nul uitkomt. Er is zelfs een plugin om ervoor te zorgen dat transacties in het bestand op datum zijn gesorteerd (autobean.sorted) om boekingen buiten volgorde op te sporen.
• Automatisering: De beancount-asset-transfer-plugin kan boekingen voor girale overdrachten tussen rekeningen genereren (nuttig voor het verplaatsen van aandelen tussen brokers met behoud van kostprijsbasis). Een andere, autobean.xcheck, kruiscontroleert je Beancount-grootboek tegen externe afschriften op discrepanties.
• Terugkerende transacties en budgetten: De “repeat”- of interpolate-plugin van Akuukis maakt het mogelijk om terugkerende transacties te definiëren of een jaarlijkse uitgave over maanden te spreiden. Voor budgettering ondersteunt de fava-envelope-extensie (gebruikt via Fava) de envelopbudgetteringsmethode in platte tekst. Er is ook MiniBudget van Frank Davies – een klein zelfstandig hulpmiddel geïnspireerd door Beancount om te helpen met budgetteren voor persoonlijk of klein zakelijk gebruik.
• Belasting en rapportage: Sommige plugins helpen bij belastingboekhouding, zoals een die vermogenswinsten automatisch classificeert in kort vs. langetermijn. Een andere (fincen_114 van Justus Pendleton) genereert een FBAR-rapport voor Amerikaanse belastingbetalers met buitenlandse rekeningen, wat illustreert hoe Beancount-gegevens kunnen worden benut voor wettelijke rapportage.
• Community-pluginrepositories: Er zijn samengestelde pluginsets zoals beancount-plugins (door Dave Stephens) die zich richten op zaken als afschrijvingsboekingen, en beancount-plugins-zack (door Stefano Zacchiroli) die diverse hulpmiddelen bevatten, zoals het sorteren van richtlijnen.

Naast plugins richten andere hulpprogramma’s rond Beancount zich op specifieke behoeften. beancount-black is bijvoorbeeld een autoformatter vergelijkbaar met de Black-codeformatter, maar voor Beancount-grootboekbestanden. Er is een Beancount Bot (Telegram/Mattermost) voor het toevoegen van transacties via chat zoals eerder vermeld, en een Alfred-workflow voor macOS om snel transacties aan je bestand toe te voegen. Een hulpmiddel genaamd Pinto biedt een “supercharged” CLI met interactieve invoer (zoals een verbeterde bean-add). Voor degenen die migreren van andere systemen bestaan er converters (YNAB2Beancount, CSV2Beancount, GnuCash2Beancount, Ledger2Beancount) om gegevens van elders binnen te halen.

Samenvattend is het Beancount-ecosysteem vrij uitgebreid. Tabel 1 hieronder toont enkele belangrijke hulpmiddelen en extensies met hun rol:

| Converters (migratiehulpmiddelen) | Hulpprogramma’s om gegevens uit andere formaten naar Beancount te converteren, bijv. van GnuCash of Ledger CLI naar Beancount-formaat. Vergemakkelijken de adoptie van Beancount zonder vanaf nul te beginnen. |

| bea CLI (Beancount.io) | Gehoste en lokaal vriendelijke CLI (bea check, bea query, bea import, bea report, …) gedocumenteerd in de CLI-referentie. Verpakt Beancount 3-tooling voor dagelijkse grootboekoperaties. | | Open Grootboek | Publieke bedrijfsgrootboeken gepubliceerd als Beancount-bestanden en ingebed in winstaankondigingen — zie /open-ledger en de gemeenschapsshowcase voor hoe platte-tekstboeken reizen. |

Gehoste CLI en Open Ledger (toegevoegd 2026)​

Twee onderdelen die dun of ontbrekend waren toen dit overzicht voor het eerst werd opgesteld, maken nu deel uit van de dagelijkse Beancount.io-workflow:

• bea CLI — De Beancount CLI-referentie en CLI-snelstart behandelen het valideren van grootboeken, het uitvoeren van BQL, het importeren van bankbestanden en het produceren van rapporten zonder dat je afzonderlijke bean-*-entrypoints hoeft te beheren. Geef de voorkeur aan bea check / bea query bij het volgen van voorbeelden in de huidige documentatie.
• Open Ledger — Publieke boekjaren voor geselecteerde bedrijven bestaan als Beancount-repositories en verschijnen via ledger-embeds op de blog. Blader door de inventaris op /open-ledger; de modelleringswalkthrough is Model een publiek bedrijf in Beancount.

Vergelijking met Ledger, hledger en soortgelijke systemen​

Beancount behoort tot de familie van boekhoudhulpmiddelen in platte tekst met dubbel boekhouden, waaronder Ledger CLI (Ledger van John Wiegley) en hledger prominent zijn. Hoewel al deze systemen het kernidee van grootboekbestanden in platte tekst en dubbel boekhouden delen, verschillen ze in syntaxis, filosofie en volwassenheid van het ecosysteem. De volgende tabel belicht de belangrijkste verschillen tussen Beancount, Ledger en hledger:

Samenvattend onderscheidt Beancount zich door zijn nadruk op striktheid, plugin-gebaseerde uitbreidbaarheid en een gebruiksvriendelijke webinterface. Ledger blijft het klassieke, zeer flexibele hulpmiddel dat de voorkeur geniet van commandoregel-puristen en degenen die ultieme snelheid nodig hebben (Ledger’s C++-engine is zeer snel op enorme bestanden). hledger biedt een middenweg – veel van Ledger’s functionaliteit met iets meer structuur en een officieel ondersteunde (zij het eenvoudige) web-UI. Alle drie delen de voordelen van boekhouding in platte tekst (controleerbaarheid, Git-versiebeheer, platte gegevens), maar Beancount’s ecosysteem (vooral met Fava) heeft het de afgelopen jaren misschien toegankelijker gemaakt voor de gemiddelde gebruiker. Aan de andere kant waarderen Ledger/hledger-gebruikers soms hun relatieve eenvoud in opzet (geen Python nodig) en lang bewezen stabiliteit. Uiteindelijk komt de keuze tussen hen neer op persoonlijke voorkeur: degenen die rigoureuze correctheid en een rijk ecosysteem waarderen, neigen vaak naar Beancount, terwijl degenen die slanke, terminalgerichte hulpmiddelen willen, misschien bij Ledger of hledger blijven.

Gebruiksscenario’s voor Beancount​

Beancount is veelzijdig genoeg om te worden gebruikt voor het volgen van persoonlijke financiën en (in sommige gevallen) boekhouding voor kleine bedrijven. De kernaanpak van dubbel boekhouden is in beide scenario’s hetzelfde, maar de schaal en specifieke praktijken kunnen verschillen.

Persoonlijke financiën​

Veel Beancount-gebruikers gebruiken het om hun individuele of huishoudelijke financiën te beheren. Een typische opzet voor persoonlijke financiën in Beancount kan rekeningen omvatten voor betaal- en spaarrekeningen, creditcards, beleggingen, leningen, inkomenscategorieën (salaris, rente, enz.) en uitgavecategorieën (huur, boodschappen, entertainment, enz.). Gebruikers registreren dagelijkse transacties handmatig (bonnen, rekeningen, enz. invoeren) of door import uit bankafschriften met behulp van de eerder besproken importeurhulpmiddelen. De voordelen die Beancount biedt voor persoonlijke financiën zijn onder meer:

• Consolidatie en analyse: Al je transacties kunnen in één tekstbestand (of een set bestanden) leven dat jaren financiële geschiedenis vertegenwoordigt. Dit maakt het gemakkelijk om langetermijntrends te analyseren. Met Beancount’s querytaal of met Fava kun je vragen beantwoorden zoals “Hoeveel heb ik de afgelopen 5 jaar aan reizen uitgegeven?” of “Wat is mijn gemiddelde maandelijkse boodschappenrekening?” in seconden. Een gebruiker merkte op dat na de overstap naar Beancount, “analyse van financiële gegevens (uitgaven, giften, belastingen, enz.) triviaal is” via Fava of door de gegevens op te vragen en hulpmiddelen zoals Pandas te gebruiken. In essentie wordt je grootboek een persoonlijke financiële database die je naar believen kunt doorzoeken.

• Budgettering en planning: Hoewel Beancount geen budgetsysteem oplegt, kun je er een implementeren. Sommige gebruikers doen envelopbudgettering door budgetrekeningen te creëren of de fava-envelope-plugin te gebruiken. Anderen gebruiken eenvoudigweg periodieke rapporten om uitgaven met doelen te vergelijken. Omdat het platte tekst is, is integratie van Beancount met externe budgetteringshulpmiddelen of spreadsheets eenvoudig (gegevens exporteren of CSV-uitvoer van query’s gebruiken).

• Beleggingen en vermogensvolging: Beancount blinkt uit in het volgen van beleggingen dankzij de robuuste afhandeling van kostprijsbasis en marktprijzen. Je kunt aan- en verkopen van aandelen, crypto, enz. met kostgegevens registreren en vervolgens Prices-richtlijnen gebruiken om de marktwaarde bij te houden. Fava kan een vermogen-over-tijd-grafiek en portefeuille-uitsplitsing per activaklasse tonen. Dit is enorm nuttig voor persoonlijk vermogensbeheer – je krijgt inzichten vergelijkbaar met wat commerciële hulpmiddelen zoals Mint of Personal Capital bieden, maar volledig onder jouw controle. Meervoudige valutacompatibiliteit is ook ingebouwd, dus als je vreemde valuta of crypto aanhoudt, kan Beancount die volgen en voor rapportage converteren.

• Investeringen en vermogensopvolging: Beancount blinkt uit in het bijhouden van investeringen dankzij de robuuste verwerking van kostprijzen en marktprijzen. Je kunt aankopen/verkopen van aandelen, crypto, enz. registreren met kostendetails, en vervolgens Prices-richtlijnen gebruiken om de marktwaarde bij te houden. Fava kan een nettovermogen over tijd-grafiek en portefeuille-uitsplitsing per activaklasse tonen. Dit is enorm nuttig voor persoonlijk vermogensbeheer – je krijgt inzichten vergelijkbaar met commerciële tools zoals Mint of Personal Capital, maar volledig onder jouw controle. Voor een geprijsde, gerangschikte blik op die dashboards, zie de Mint-alternatieven-rondleiding en de Empower / Personal Capital-alternatieven-rondleiding. Multi-valuta-ondersteuning is ook ingebouwd, dus als je buitenlandse valuta of crypto aanhoudt, kan Beancount die bijhouden en omzetten voor rapportage.

• Reconciliatie en nauwkeurigheid: Persoonlijke financiën omvatten vaak het afstemmen met bankafschriften. Met Beancount kan men regelmatig rekeningen reconciliëren door saldo-asserties of de documentenfunctie te gebruiken. Je kunt bijvoorbeeld elke maand een balance Assets:Bank:Checking <date> <balance>-boeking toevoegen om te bevestigen dat je grootboek overeenkomt met het bankafschrift aan het einde van de maand. De bean-check-tool (of Fava’s foutweergave) waarschuwt je als dingen niet kloppen. Een gebruiker noemt het maandelijks reconciliëren van alle rekeningen, wat “helpt om ongebruikelijke activiteiten op te sporen” – een goede persoonlijke financiële hygiënepraktijk die Beancount faciliteert.

• Automatisering: Technisch onderlegde individuen hebben grote delen van hun persoonlijke financiële workflow geautomatiseerd met Beancount. Met importeurs, cron-jobs en misschien wat Python kun je je systeem zo opzetten dat bijvoorbeeld elke dag je banktransacties worden opgehaald (sommigen gebruiken OFX of API’s) en aan je Beancount-bestand worden toegevoegd, gecategoriseerd door regels. Na verloop van tijd wordt je grootboek grotendeels automatisch bijgewerkt en hoef je alleen nog te controleren en aan te passen. Een communitylid op Hacker News deelde dat na 3 jaar hun Beancount-boeken “95% automatisch” waren. Dit niveau van automatisering is mogelijk vanwege Beancount’s openheid van platte tekst en scriptingmogelijkheden.

Gebruikers van persoonlijke financiën kiezen vaak voor Beancount boven spreadsheets of apps omdat het hen volledige eigendom van de gegevens geeft (geen afhankelijkheid van een cloudservice die kan worden stopgezet – een zorg toen Mint bijvoorbeeld werd stopgezet) en omdat de diepte van inzicht groter is wanneer al je gegevens zijn geïntegreerd. De leercurve is niet triviaal – men moet basisboekhouding en de Beancount-syntaxis leren – maar bronnen zoals de officiële documentatie en community-tutorials helpen nieuwkomers op weg. Eenmaal opgezet, vinden velen dat het gemoedsrust brengt om altijd een duidelijk, betrouwbaar beeld van hun financiën te hebben.

Boekhouding voor kleine bedrijven​

Het gebruik van Beancount voor een klein bedrijf (of non-profitorganisatie, club, enz.) komt minder vaak voor dan persoonlijk gebruik, maar het is zeker mogelijk en sommigen hebben het met succes gedaan. Beancount’s raamwerk voor dubbel boekhouden is in feite hetzelfde systeem dat ten grondslag ligt aan bedrijfsboekhouding, alleen zonder enkele van de hogere functies die gespecialiseerde boekhoudsoftware biedt (zoals facturatiemodules of salarisintegraties). Hier is hoe Beancount in een kleine bedrijfscontext kan passen:

• Grootboek en financiële overzichten: Een klein bedrijf kan het Beancount-bestand als zijn grootboek behandelen. Je zou activarekeningen hebben voor bankrekeningen, debiteuren, misschien inventaris; passivarekeningen voor creditcards, leningen, crediteuren; eigen vermogen voor het kapitaal van de eigenaar; inkomensrekeningen voor verkopen of diensten; en uitgavenrekeningen voor alle bedrijfsuitgaven. Door dit grootboek bij te houden, kun je op elk moment een resultatenrekening (winst & verlies) en balans produceren met behulp van Beancount’s rapporten of query’s. Beancount’s ingebouwde rapporten of Fava kunnen in seconden een balans en winst-en-verliesrekening genereren die volledig in overeenstemming zijn met boekhoudprincipes. Dit kan voldoende zijn voor een kleine operatie om winstgevendheid, financiële positie en kasstroom te beoordelen (met wat query’s voor kasstroom, aangezien directe kasstroomoverzichten niet ingebouwd zijn maar kunnen worden afgeleid).
• Facturen en debiteuren/crediteuren: Beancount heeft geen ingebouwd facturatiesysteem; gebruikers zouden facturatie doorgaans buiten Beancount afhandelen (bijv. facturen maken in Word of een facturatie-app) en vervolgens de resultaten in Beancount registreren. Wanneer je bijvoorbeeld een factuur uitschrijft, zou je een boeking maken die debiteuren debiteert en inkomsten crediteert. Wanneer de betaling binnenkomt, debiteer je Contant/Bank en crediteer je Debiteuren. Op deze manier kun je openstaande debiteuren bijhouden door naar het saldo van de debiteurenrekening te kijken. Hetzelfde geldt voor rekeningen (crediteuren). Hoewel het handmatiger is dan gespecialiseerde boekhoudsoftware (die herinneringen kan sturen of met e-mails kan integreren), is het perfect uitvoerbaar. Sommige gebruikers hebben sjablonen of workflows gedeeld over hoe ze facturen met Beancount beheren en ervoor zorgen dat ze geen openstaande facturen missen (bijvoorbeeld door metadata of aangepaste query’s te gebruiken om onbetaalde facturen op te sommen).
• Inventaris of kostprijs van verkochte goederen: Voor bedrijven die producten verkopen, kan Beancount inventarisaankopen en -verkopen volgen, maar het vereist gedisciplineerde boekingen. Je zou de Inventory- en kostenboekhoudfuncties kunnen gebruiken: het kopen van inventaris verhoogt een activarekening (met kosten verbonden aan de artikelen), het verkopen ervan verplaatst kosten naar een uitgave (COGS) en registreert omzet. Omdat Beancount aandringt op lotmatching, dwingt het een correcte vermindering van inventaris met de juiste kosten af, wat er zelfs voor kan zorgen dat je brutowinstberekeningen correct zijn als het goed wordt gedaan. Er is echter geen geautomatiseerde SKU-tracking of iets dergelijks – het is allemaal op financieel niveau (hoeveelheid en kosten).
• Salarisadministratie en complexe transacties: Beancount kan salaristransacties registreren (salariskosten, belastinginhoudingen, enz.), maar het berekenen van die cijfers kan extern of via een ander hulpmiddel gebeuren en vervolgens alleen in Beancount worden geboekt. Voor een zeer klein bedrijf (bijvoorbeeld één of twee werknemers) is dit beheersbaar. Je zou bijvoorbeeld per loonperiode één journaalboeking maken die lonen, ingehouden belasting, werkgeversbelastingkosten, betaald geld, enz. uitsplitst. Dit handmatig doen is vergelijkbaar met hoe men het in QuickBooks-journaalboekingen zou doen – het vereist kennis van welke rekeningen moeten worden gebruikt.
• Meerdere gebruikers en audit: Een uitdaging in een bedrijfscontext is wanneer meerdere mensen toegang moeten hebben tot de boeken of wanneer een accountant ze moet beoordelen. Omdat Beancount een tekstbestand is, is het niet realtime multi-user. Door het bestand echter in een Git-repository te hosten, kan samenwerking mogelijk worden: elke persoon kan bewerken en committen, en verschillen kunnen worden samengevoegd.
• Wettelijke naleving: Voor belastingaangifte of naleving kunnen Beancount’s gegevens worden gebruikt om de benodigde rapporten te genereren, maar dit kan aangepaste query’s of plugins vereisen. We zagen een voorbeeld van een community-plugin voor Indiase overheidsnalevingsrapportage en een voor FinCEN FBAR-rapportage. Dit toont aan dat Beancount, met inspanning, kan worden aangepast aan specifieke rapportagevereisten. Kleine bedrijven in rechtsgebieden met eenvoudige vereisten (kasboekhouding of basis accrual) kunnen zeker boeken in Beancount bijhouden en financiële overzichten voor belastingaangiften produceren. Functies zoals afschrijvingsschema’s of amortisatie vereisen echter mogelijk dat je je eigen boekingen schrijft of een plugin gebruikt (de afschrijvingsplugins van Dave Stephens helpen bijvoorbeeld om dat te automatiseren). Er is geen GUI om op “activa afschrijven” te klikken zoals in sommige boekhoudsoftware; je zou de afschrijving als transacties coderen (wat het op een manier demystificeert – alles is een boeking die je kunt inspecteren).

In de praktijk hebben veel technisch georiënteerde kleine bedrijfseigenaren Beancount (of Ledger/hledger) gebruikt als ze de voorkeur geven aan controle en transparantie boven het gemak van QuickBooks. Een Reddit-discussie merkte op dat voor standaard boekhouding voor kleine bedrijven met een beperkt aantal transacties, Beancount prima werkt. De beperkende factor is meestal het comfortniveau – of de bedrijfseigenaar (of hun accountant) zich op zijn gemak voelt met een op tekst gebaseerd hulpmiddel. Een voordeel is de kosten: Beancount is gratis, terwijl boekhoudsoftware duur kan zijn voor een klein bedrijf. Aan de andere kant betekent het gebrek aan officiële ondersteuning en de doe-het-zelf-aard dat het het meest geschikt is voor degenen die zowel de bedrijfseigenaar zijn als enigszins technisch onderlegd. Voor freelancers of eenmanszaken met programmeervaardigheden kan Beancount een aantrekkelijke keuze zijn om financiën te beheren zonder afhankelijk te zijn van cloudboekhouddiensten.

Hybride benaderingen zijn ook mogelijk: sommige kleine bedrijven gebruiken een officieel systeem voor facturen of salarisadministratie, maar importeren de gegevens periodiek in Beancount voor analyse en archivering. Op deze manier krijgen ze het beste van beide werelden – naleving en gemak voor dagelijkse activiteiten, plus de kracht van Beancount voor geconsolideerd inzicht.

Samenvattend kan Beancount boekhouding voor kleine bedrijven aan, op voorwaarde dat de gebruiker bereid is handmatig te beheren wat commerciële software automatiseert. Het zorgt voor een hoge mate van transparantie – je begrijpt je boeken diepgaand omdat je ze schrijft – en voor een zorgvuldige gebruiker kan het onberispelijke boeken produceren. Zowel persoonlijke als zakelijke gebruikers profiteren van Beancount’s kernsterkten: een betrouwbare boekhoudengine, een volledig audit trail en flexibiliteit om zich aan unieke scenario’s aan te passen (via scripting en plugins). Of het nu gaat om het volgen van een huishoudbudget of de financiën van een startup, Beancount biedt een toolkit om dit met precisie en openheid te doen.

Community en ontwikkelingsactiviteit​

Beancount heeft een toegewijde community en een ontwikkelingsverhaal dat de open-source, niche-maar-passionele aard weerspiegelt. Hieronder staan belangrijke punten over de community, onderhouders en gerelateerde projecten:

• Projectonderhoud: Beancount’s primaire auteur is Martin Blais, die rond 2007 met het project begon en het door meerdere versies heeft geleid. Ontwikkeling was lange tijd grotendeels een eenmansinspanning (afgezien van community-bijdragen van patches). Martin’s filosofie was om een boekhoudhulpmiddel te bouwen dat “eerst nuttig voor mij is, en ook voor anderen, op de eenvoudigste, meest duurzame manier”. Deze persoonlijke motivatie hield het project gaande als een arbeid van liefde. Vanaf 2025 is Martin Blais nog steeds de hoofdonderhouder (zijn naam verschijnt op commits en hij beantwoordt vragen op de mailinglijst/issue-tracker), maar het ecosysteem rond Beancount heeft veel andere bijdragers in hun respectieve projecten.

• GitHub en repositories: De broncode wordt gehost op GitHub onder de beancount/beancount-repository. Het project is GPL-2.0-licentie en heeft in de loop der jaren een bescheiden aantal bijdragers aangetrokken. Midden 2024 werd Beancount Versie 3 officieel uitgebracht als de nieuwe stabiele tak. Deze release omvatte het opsplitsen van sommige componenten: de beangulp-repo (voor importeurs) en beanquery-repo (voor de querytool) maken nu bijvoorbeeld deel uit van de beancount GitHub-organisatie en worden enigszins onafhankelijk onderhouden. De belangrijkste Beancount-repo richt zich op de kernboekhoudengine en bestandsparser. Vanaf 2025 toont Beancount’s GitHub actieve issue-discussies en enige lopende ontwikkeling – hoewel niet hoogvolume, druppelen issues en pull-requests binnen en worden er af en toe updates gemaakt om bugs op te lossen of functies te verfijnen.

• Fava-ontwikkeling: Fava, de webinterface, begon als een apart project (gemaakt door Dominic Aumayr, die het in 2016 auteursrechtelijk beschermde). Het heeft zijn eigen community van bijdragers en is ook op GitHub onder beancount/fava. Fava’s onderhouders en bijdragers (bijv. Jakob Schnetz, Stefan Otte en anderen in de afgelopen jaren) hebben de interface actief verbeterd, met releases om de paar maanden. Fava’s Gitter-chat (gelinkt op de Fava-documentatie) en GitHub-issue-tracker zijn plaatsen waar gebruikers en ontwikkelaars nieuwe functies of bugs bespreken. Het project verwelkomt bijdragen, zoals blijkt uit een CHANGELOG-notitie waarin meerdere communityleden worden bedankt voor hun PR’s. Fava’s nauwe afstemming op Beancount’s ontwikkeling (zoals het snel toevoegen van ondersteuning voor Beancount v3 en nieuwe beanquery-syntaxis) duidt op goede samenwerking tussen de twee projecten.

• Mailinglijsten en forums: Beancount heeft een officiële mailinglijst (voorheen op Google Groups, getiteld “Beancount” of soms besproken op de algemene Ledger-lijst). Deze mailinglijst is een schatkamer van kennis – gebruikers stellen vragen over het modelleren van bepaalde scenario’s, melden bugs en delen tips. Het is bekend dat Martin Blais op de mailinglijst reageert met gedetailleerde uitleg. Daarnaast overlapt de bredere Plain Text Accounting-community sterk. De Ledger CLI-mailinglijst behandelt vaak ook vragen over Beancount, en er is een forum op plaintextaccounting.org en een subreddit r/plaintextaccounting waar Beancount-onderwerpen regelmatig voorkomen. Gebruikers op deze platforms bespreken vergelijkingen, delen persoonlijke opstellingen en helpen nieuwkomers. De algemene toon van de community is zeer coöperatief – Beancount-gebruikers helpen vaak Ledger-gebruikers en vice versa, in het besef dat al deze hulpmiddelen vergelijkbare doelen hebben.

• Chatgroepen: Naast mailinglijsten zijn er chatkanalen zoals de Plaintext Accounting Slack/Discord (community-georganiseerd) en Fava Gitter. Deze zijn minder formeel en meer realtime manieren om hulp te krijgen of functies te bespreken. Je kunt bijvoorbeeld de Slack opgaan om te vragen of iemand een importeur voor een specifieke bank heeft. Er is ook een Matrix/IRC-kanaal (historisch #ledger of #beancount op IRC) waar enkele trouwe gebruikers aanwezig zijn. Hoewel niet zo bevolkt als communities voor reguliere software, hebben deze kanalen deskundige mensen die vaak duistere boekhoudvragen kunnen beantwoorden.

• Bijdragers en belangrijke communityleden: Een paar namen vallen op in de Beancount-community:

  • “Redstreet” (Red S): Een productieve bijdrager die veel plugins heeft geschreven (zoals beancount-balexpr, sellgains en andere) en vaak ondersteuning biedt. Ze onderhouden ook een set importeurscripts en een hulpmiddel genaamd bean-download om afschriften op te halen.
  • Vasily M (Evernight): Auteur van enkele importeursraamwerken en plugins zoals beancount-valuation, en bijdragen aan Fava met betrekking tot beleggingen.
  • Stefano Zacchiroli (zack): Een Debian-ontwikkelaar die de beancount-mode voor Emacs en zijn eigen plugin-repo creëerde. Hij heeft ook gepleit voor boekhouding in platte tekst in academische omgevingen.
  • Simon Michael: Hoewel voornamelijk de leider van hledger, beheert hij plaintextaccounting.org dat Beancount omvat. Deze kruisbestuiving hielp Beancount onder de aandacht te brengen van Ledger/hledger-gebruikers.
  • Frank hell (Tarioch): Bijdrager van Tarioch Beancount Tools, een belangrijke set importeurs en prijsophalers, vooral voor Europese instellingen.
  • Siddhant Goel: Een communitylid dat blogt over Beancount (bijvoorbeeld zijn gids over migreren naar v3) en enkele importeurs onderhoudt. Zijn blogposts hebben veel nieuwe gebruikers geholpen.

  Deze en vele anderen dragen code, documentatie en hulp op forums bij, waardoor het ecosysteem levendig blijft ondanks zijn relatief kleine omvang.

• GitHub-statistieken en forks: Beancount’s GitHub-repo heeft een paar honderd sterren verzameld (wat interesse aangeeft) en forks. Opmerkelijke forks van Beancount zelf zijn zeldzaam – er is geen bekende uiteenlopende fork die probeert “Beancount maar dan met functie X” te zijn. In plaats daarvan schreven gebruikers, wanneer ze iets anders wilden, een plugin of gebruikten ze een ander hulpmiddel (zoals hledger) in plaats van Beancount te forken. Men zou hledger kunnen beschouwen als een soort fork van Ledger (niet van Beancount) en Beancount zelf als een onafhankelijke herinterpretatie van Ledger’s ideeën, maar binnen Beancount’s repo zijn er geen grote afsplitsingsprojecten. De community is over het algemeen samengekomen rond de hoofdrepo en heeft deze uitgebreid via de plugin-interface in plaats van de codebase te fragmenteren. Dit komt waarschijnlijk omdat Martin Blais open stond voor externe bijdragen (zijn documentatie heeft zelfs een sectie die externe bijdragen en modules erkent) en de pluginarchitectuur het onnodig maakte om voor de meeste nieuwe functies een fork te onderhouden.

• Communitybronnen: Er zijn verschillende hoogwaardige bronnen voor het leren en gebruiken van Beancount die door de community zijn gemaakt:

  • De Beancount-documentatie op GitHub Pages (en de Google Docs-bron die Martin onderhoudt) – zeer uitgebreid, inclusief theorie over boekhouding en hoe Beancount dit implementeert.

  • Talrijke blogposts en persoonlijke notities – bijvoorbeeld had LWN.net een artikel “Counting beans… with Beancount”, en veel persoonlijke blogs (zoals vermeld in de “Blog Posts”-sectie van Awesome Beancount) delen ervaringen en tips. Deze helpen bij het opbouwen van kennis en trekken nieuwe gebruikers aan.

  • Lezingen en presentaties: Beancount is gepresenteerd op meetups en conferenties (bijvoorbeeld een PyMunich 2018-lezing over het beheren van financiën met Python/Beancount). Dergelijke lezingen introduceren het hulpmiddel bij een breder publiek en wekken vaak belangstelling op forums zoals Hacker News.

• Opmerkelijke gerelateerde projecten: Naast Fava hebben enkele andere projecten gerelateerd aan Beancount hun eigen communities:

  • Plain Text Accounting-site – onderhouden door Simon Michael, aggregeert informatie over al dergelijke hulpmiddelen en heeft een forum waar mensen gebruik voor verschillende hulpmiddelen, waaronder Beancount, delen.
  • Integratie met financiële hulpmiddelen: Sommige gebruikers integreren Beancount met business intelligence-hulpmiddelen of databases. Een Google Groups-thread beschrijft bijvoorbeeld het gebruik van PostgreSQL met Beancount-gegevens via aangepaste functies. Hoewel niet mainstream, toont het de experimentele geest van de community om Beancount’s mogelijkheden te verleggen (bijv. om zeer grote datasets of complexe query’s aan te kunnen die verder gaan dan de ingebouwde).

Samenvattend is Beancount’s community, hoewel kleiner dan die van grote open-sourceprojecten, zeer betrokken en deskundig. Het project geniet een gestage stroom van verbeteringen en zeer behulpzame ondersteuningskanalen. De coöperatieve ethos (het delen van importeurs, het schrijven van plugins, het beantwoorden van vragen) betekent dat een nieuwkomer in 2025 kan vertrouwen op uitgebreid eerder werk en community-wijsheid om hun boekhoudsysteem op te zetten. Ontwikkeling is actief in de zin van het ecosysteem – Fava-releases, plugin-ontwikkeling, enz. – zelfs als de kernwijzigingen meer incidenteel zijn. De groei van het ecosysteem (zoals blijkt uit de Awesome Beancount-lijst van tientallen hulpmiddelen) getuigt van een gezonde community die Beancount steeds capabeler maakt.

Recente ontwikkelingen en aankomende functies​

Voor Beancount.io’s onderzoek naar boekhoudautomatisering, bezoek je Bean Labs om de onderzoekslogboeken en methoden te verkennen.

Vanaf 2025 heeft het Beancount-ecosysteem de afgelopen jaren belangrijke ontwikkelingen doorgemaakt en er zijn lopende discussies over toekomstige verbeteringen. Hier zijn enkele opmerkelijke recente ontwikkelingen en een glimp van wat er mogelijk gaat komen:

• Beancount 3.0-release (2024): Na een lange periode waarin Beancount 2.x de standaard was, werd versie 3 medio 2024 officieel uitgebracht. Dit was een belangrijke mijlpaal omdat v3 een vereenvoudiging en modernisering van de codebase vertegenwoordigt. Martin Blais had v3 voor ogen als een kans om het systeem verder te “herschikken en vereenvoudigen”. Hoewel oorspronkelijk gedacht werd als een grote herschrijving, was de update voor gebruikers in de praktijk niet al te verstorend. De belangrijkste wijzigingen vonden onder de motorkap plaats: een nieuwe parser, enkele prestatieverbeteringen en het uitsplitsen van optionele componenten uit de kern. De release werd geleidelijk uitgerold (v3 was sinds 2022 in bèta, maar tegen juli 2024 werd het de aanbevolen stabiele versie). Gebruikers zoals Siddhant Goel meldden dat migreren van 2.x naar 3.x “meestal zonder problemen” verliep, met slechts een paar workflowwijzigingen.

• Modularisering – hulpmiddelen verplaatst naar afzonderlijke pakketten: Een van de grote wijzigingen met Beancount 3 is dat veel hulpmiddelen die vroeger in de monolithische repository leefden, zijn afgesplitst. bean-query wordt nu bijvoorbeeld geleverd door het beanquery-pakket en beancount.ingest werd vervangen door het beangulp-pakket. Opdrachten zoals bean-extract en bean-identify (voor import) werden uit de kern van Beancount verwijderd. In plaats daarvan is de filosofie om zelfstandige scripts voor import te gebruiken. Dit betekent dat als je naar v3 upgradet, je beangulp installeert en importeurscripts uitvoert (elke importeur is in wezen een klein programma) in plaats van een centraal bean-extract-configuratiebestand. Op dezelfde manier worden query’s uitgevoerd via beanquery, dat onafhankelijk van de Beancount-kern kan worden geïnstalleerd en bijgewerkt. Deze modulaire aanpak is ontworpen om onderhoud gemakkelijker te maken en community-bijdragen aan te moedigen. Het maakte Beancount’s kern ook slanker, zodat de kern zich puur richt op parsing en boekhoudlogica, terwijl ondersteunende functionaliteit afzonderlijk kan evolueren. Vanuit gebruikersperspectief moet men na de upgrade opdrachten aanpassen (bijv. bean-query van beanquery gebruiken, of Fava gebruiken dat dit toch al abstracteert). Fava’s changelog vermeldt deze wijzigingen expliciet: Fava hangt nu af van beanquery en beangulp en behandelt importworkflows anders voor Beancount 3 vs 2.

• Prestatieverbeteringen: Prestaties waren een motivatie om Beancount’s ontwerp opnieuw te bekijken. Het v3-plan (zoals uiteengezet in Martin’s “V3-doelen”-document) omvatte het optimaliseren van de parser en mogelijk het sneller en minder geheugenintensief maken van het laadproces. Tegen 2025 zijn sommige van deze verbeteringen gerealiseerd. Anekdotisch melden gebruikers met zeer grote grootboeken (tienduizenden transacties of veel aandelenhandel) betere prestaties met de nieuwste versie. Een gebruiker die te maken had met “micro-investeringstransacties” en prestatieproblemen ondervond, uitte bijvoorbeeld deze zorgen op de Google Group – dit soort feedback heeft waarschijnlijk v3 beïnvloed. De nieuwe parser is efficiënter en op een duidelijkere manier geschreven, wat in de toekomst kan worden uitgebreid. Bovendien is Fava 1.29 overgeschakeld op een efficiënter bestandsbewakingsmechanisme (met behulp van de watchfiles-bibliotheek) om de responsiviteit te verbeteren wanneer het grootboek verandert. Vooruitkijkend zou de community incrementeel parseren kunnen verkennen (alleen gewijzigde delen van het bestand opnieuw verwerken in plaats van alles) om grote grootboeken sneller te verwerken – dit werd gesuggereerd in de documentatie als een idee voor “Beancount-server / incrementele boeking”.

• Verbeteringen aan beleggingsvolging: Er is voortdurend werk verzet om beleggings- en portefeuillerapportage beter te maken. De afhandeling van gemiddelde kostprijsbasis versus FIFO werd bijvoorbeeld uitvoerig besproken. Hoewel Beancount lotmatching afdwingt, geven sommige gebruikers de voorkeur aan gemiddelde kosten voor bepaalde rechtsgebieden. Er bestaat een voorstel en discussie over het flexibeler maken van kostprijsbasisboeking (mogelijk via een plugin of optie). Tegen 2025 is er geen ingebouwde schakelaar voor gemiddelde kosten aanwezig, maar de basis in v3 (de herontworpen boeking) maakt het gemakkelijker voor plugins om dit te implementeren. Een community-plugin “Gains Minimizer” werd uitgebracht die kan voorstellen welke loten je moet verkopen om belastingen te minimaliseren, wat laat zien wat voor geavanceerde hulpmiddelen er rond beleggingen worden gebouwd. Fava voegde ook functies toe zoals een portefeuilleoverzichtextensie (met berekeningen van rendement). Wat aankomende functies betreft, kan men meer in dit domein verwachten: mogelijk geautomatiseerde suggesties voor portefeuille-herbalancering of risicoanalyse, waarschijnlijk als externe hulpmiddelen die Beancount-gegevens lezen (aangezien de gegevens er allemaal zijn).

• Nieuwe plugins en extensies: Het plugin-ecosysteem groeit voortdurend. Recente opmerkelijke toevoegingen zijn onder meer:

  • Budgetrapportagehulpmiddelen – bijvoorbeeld een eenvoudige CLI-budgetreporter als je Fava’s UI niet gebruikt.
  • Encryptie en beveiliging – de fava-encrypt-opstelling, waarmee Fava online kan worden gehost met het grootboek versleuteld in rust, werd geïntroduceerd, waarmee de zorg van zelfhosting van je financiën wordt aangepakt.
  • Kwaliteit-van-leven-plugins – zoals autobean-format (een nieuwe formatter die meer randgevallen kan afhandelen door het bestand te parsen en opnieuw af te drukken) en beancheck-integratie in editors (flymake voor Emacs).

  Vooruitkijkend zal de community waarschijnlijk gaten blijven vullen via plugins. We zouden bijvoorbeeld meer belastinggerelateerde plugins kunnen zien (sommige gebruikers hebben scripts gedeeld voor het berekenen van wash sales of specifieke lokale belastingrapporten).

• Potentiële aankomende functies: Op basis van discussies op de issue-tracker en mailinglijst staan een paar ideeën op de horizon (hoewel niet gegarandeerd):

  • Tijdresolutie: Momenteel volgt Beancount alleen datums (geen tijdstempels) voor transacties. Er zijn vragen geweest over het toevoegen van tijd (voor aandelenhandel of het ordenen van transacties op dezelfde dag). Martin Blais besloot expliciet dat sub-dag tijdstempels buiten de scope vielen om dingen eenvoudig te houden. Dit zal waarschijnlijk niet snel veranderen – dus aankomende versies zullen waarschijnlijk geen tijdresolutie toevoegen, vasthoudend aan het standpunt dat als je tijd nodig hebt, je het in de omschrijving of een rekening verwerkt.
  • Verbeterde GUI-bewerking: Fava verbetert voortdurend zijn bewerkingsmogelijkheden. Een mogelijkheid is een volledigere webeditor (met automatische suggestie, misschien een formuliergebaseerde invoer voor nieuwe transacties). De basis met tree-sitter in Fava’s editor is gelegd. We zouden kunnen zien dat Fava niet alleen een viewer wordt, maar een krachtigere editor, waardoor de noodzaak om voor veel taken een teksteditor te openen afneemt.
  • Betere ondersteuning voor meerdere grootboeken: Sommige gebruikers onderhouden meerdere Beancount-bestanden (voor verschillende entiteiten of voor het splitsen van persoonlijk vs. zakelijk). Het opnemen van bestanden is momenteel mogelijk, maar had beperkingen (plugins in opgenomen bestanden, enz.). Een recente plugin autobean.include is gemaakt om externe grootboeken veilig op te nemen. In de toekomst zouden we eersteklas ondersteuning voor meerdere bestandsopstellingen kunnen zien – misschien een concept van een Beancount-“project” met meerdere bestanden (dit wordt gesuggereerd door functies zoals de beancount.mainBeanFile-instelling van de VSCode-extensie). Dit zou degenen helpen die multi-entiteit-boekhouding doen of hun grootboek willen modulariseren.
  • Realtime of incrementele berekening: Naarmate grootboeken groeien, wordt het vermogen om rapporten snel opnieuw te berekenen belangrijk. Er is een idee van een Beancount-server die blijft draaien en resultaten bijwerkt terwijl transacties veranderen. Dit zou kunnen verschijnen als een optimalisatie in Fava of een daemon waar editor-plugins naar kunnen vragen. Misschien zal een toekomstige Fava-release een continu draaiend Beancount-proces gebruiken om de UI responsiever te maken voor enorme grootboeken.
  • Fondsenboekhouding / non-profitorganisatiefuncties: Er was een verbeteringsvoorstel over fondsenboekhouding in Beancount. Non-profitorganisaties hebben boekhoudbehoeften (beperkte vs. onbeperkte fondsen) die mogelijk kunnen worden gemodelleerd met Beancount’s tag- of rekeninghiërarchie. De discussie leidde nog niet tot ingebouwde functies, maar als meer non-profitorganisaties Beancount adopteren, zou dit nieuwe mogelijkheden kunnen stimuleren (misschien alleen gedocumenteerde best practices of plugins voor fondssaldi-volging).

• Langetermijnvooruitzicht: Martin Blais suggereerde dat hij de toekomst van Beancount ziet in het maken van de kern meer een engine en het verplaatsen van meer functionaliteit naar plugins. Dit is consistent met wat we zien (modularisering in v3). Een “aankomende functie” in filosofische zin is dus grotere uitbreidbaarheid – mogelijk zelfs het toestaan dat plugins nieuwe richtlijntypen definiëren of syntaxis op gecontroleerde manieren uitbreiden. Als dat gebeurt, zou Beancount’s kern relatief klein en stabiel kunnen blijven, terwijl het ecosysteem de meeste nieuwe functionaliteit als add-ons levert. Dit zou kunnen leiden tot een pluginmarktplaats of een meer gecentraliseerde lijst van plugins zodat gebruikers kunnen kiezen (de Awesome Beancount-lijst is een begin daarmee).

Concluderend is het Beancount-ecosysteem in 2025 actief en evoluerend. De release van Beancount 3.0 was een belangrijke recente gebeurtenis, die ervoor zorgt dat de basis van het project solide is voor de toekomst. Verbeteringen in prestaties, hulpmiddelen en bruikbaarheid (vooral via Fava) hebben de toegangsdrempel verder verlaagd. Hoewel Beancount een hulpmiddel blijft dat enige expertise vereist, is het nu veel toegankelijker dan enkele jaren geleden, dankzij deze ontwikkelingen. Aankomende functies zullen zich waarschijnlijk richten op het verfijnen van de ervaring – snellere prestaties, betere integraties en gespecialiseerde extensies – in plaats van drastische wijzigingen in de kernfilosofie. De trajectorie van de community suggereert dat Beancount zal blijven rijpen als het middelpunt van boekhouding in platte tekst, een balans vindend tussen de sobere kracht van dubbel boekhouden en het gemak van moderne software. Zoals een gebruiker op Hacker News gekscherend zei, geeft boekhouding in platte tekst je “superkrachten” in het begrijpen van je financiën – en Beancount’s recente en toekomstige verbeteringen zijn erop gericht die superkrachten voor iedereen gemakkelijker hanteerbaar te maken.

Bronnen: Beancount-documentatie en repository; Fava-documentatie; “A Comparison of Beancount and Ledger” door Martin Blais; Awesome Beancount-bronnenlijst; Gebruikerservaringen en community-rapporten;