Awesome Beancount

Een samengestelde gids voor het Beancount-ecosysteem. Beancount is een krachtig, open-source boekhoudsysteem dat een eenvoudig, op tekst gebaseerd formaat gebruikt om uw financiën te beheren met de strikte regels van dubbel boekhouden. Deze pagina combineert door de community beheerde lijsten en ecosysteem-overzichten in één uitgebreide bron.

Waarom Plain Text Accounting?​

Plain text accounting (PTA) is een methodologie voor het beheren van financiën met behulp van eenvoudige tekstbestanden en krachtige command-line tools. Deze aanpak geeft u de volledige eigendom over uw gegevens, garandeert een lange levensduur en biedt ongeëvenaarde flexibiliteit voor automatisering en analyse.

• Officiële PTA Hub: Plain Text Accounting
• Een zachte introductie: Accounting for the simple minds with plain text accounting
• Van web-apps naar CLI: Command line accounting: From mint.com to Ledger

Het Beancount-ecosysteem​

Het Beancount-ecosysteem is een verzameling tools, plug-ins en bronnen gebouwd rond een kern-engine. Elk component speelt een specifieke rol in het creëren van een complete workflow voor financieel beheer.

1. Kern-engine & officiële bronnen​

Dit zijn de basiselementen van Beancount, onderhouden door de maker en officiële bijdragers.

2. Gebruikersinterfaces​

Deze tools bieden visuele interfaces voor het verkennen en bewerken van uw financiële gegevens.

3. Transacties importeren​

Importeren is het proces van het converteren van gegevens van financiële instellingen (zoals bank-CSV's of PDF's) naar Beancount-regels.

Community Importers (Per land)​

Een uitgebreide verzameling scripts voor specifieke banken en diensten, onderhouden door de community.

• China
  • Alipay / 支付宝: deb-sig/double-entry-generator, wzyboy/importer
  • China Merchants Bank (CMB): Betaalpas, Creditcard
  • WeChat Pay / 微信支付: deb-sig/double-entry-generator
• Frankrijk
  • Caisse d'Epargne: beancount-ce
  • Boursorama, Amex: Beancount-myTools
• Duitsland
  • Commerzbank: beancount-commerzbank
  • Deutsche Kredit Bank (DKB): beancount-dkb
  • ING: beancount-ing
  • N26: beancount-n26
  • Volksbank & GLS-Bank: beancount-importer-volksbank
• India
  • SBI, BOI, Paytm, HSBC, ICICI: beancount-importers-india
• Nederland
  • ABN AMRO: beancount-abnamro
• Zwitserland
  • Algemeen: tariochbctools (BCGE, Neon, Raiffeisen, ZKB, Fidelity)
  • Finpension: drnuke-bean
  • PostFinance: tariochbctools, drnuke-bean
• VK
  • Monzo, Revolut, Wise: Evernight/beancount-importers
  • Revolut, Wise: tariochbctools
• VS
  • Amex, Chase, Citi, Schwab: mterwill/gist
  • Capital One: mtlynch/beancount-capitalone
  • Chase: mtlynch/beancount-chase-bank, ArthurFDLR/beancount-chase
  • Clipper: beancount-clipper
  • Mercury: mtlynch/beancount-mercury
• Blockchain
  • tariochbctools

4. Editor-ondersteuning & hulpmiddelen​

Hulpmiddelen die Beancount integreren in je ontwikkelomgeving om bewerken en onderhoud te stroomlijnen.

• IDE-ondersteuning: Plugins die syntax-highlighting, auto-aanvulling en directe balanscontrole bieden.
  • VSCode
  • Emacs
  • Vim
  • Zed
  • Sublime Text
  • Atom
  • Beancount Language Server (voor elke editor die compatibel is met LSP)
• Automatisering & Hulpprogramma's:
  • bean-add: Interactief transacties toevoegen vanaf de opdrachtregel.
  • beancount-black: Een eigenzinnige code-formatter voor Beancount-bestanden.
  • beancount-categorizer: Automatisch transacties categoriseren met regex-regels.
  • beanahead: Beheer en projecteer toekomstige transacties.
• Data-migratiehulpmiddelen: Hulpprogramma's om gegevens van andere boekhoudsystemen te converteren.
  • Van GnuCash: henriquebastos/gc-to-bc, dtrai2/gc-to-bc
  • Van Ledger/hledger: travisdahlke/gist, zacchiro/ledger2beancount
  • Van YNAB: hoostus/beancount-ynab

5. Plugins (Ledger-extensies)​

Python-modules binnen het grootboek die tijdens de verwerking worden uitgevoerd om aangepaste regels af te dwingen, transacties te automatiseren of nieuwe functies toe te voegen.

• Budgetteren:
  • fava-envelope: Een Fava-extensie voor budgetteren volgens de enveloppen-methode.
• Automatisering & Controles:
  • autobean.share: Splitsen van uitgaven en schuldenbeheer.
  • autobean.sorted: Zorgt ervoor dat transacties chronologisch geordend zijn.
  • beancount-checkclosed: Controleert automatisch op een nulsaldo bij gesloten rekeningen.
• Datamanipulatie:
  • autobean.narration: Genereert automatisch omschrijvingen voor transacties.
  • beancount-lazy-plugins.filter_map: Past bewerkingen toe op een gefilterde groep transacties.

6. Prijsbronnen​

Scripts die historische en actuele prijzen ophalen voor grondstoffen, aandelen en valuta om de waarde van investeringen bij te houden.

• beancount-exchangerates: Voor fiat-valuta's via API's zoals frankfurter.dev.
• pricehist: Een multi-source prijs-fetcher.
• beancount-cryptoassets: Voor het ophalen van cryptocurrency-prijzen.
• tariochbctools: Bevat een prijsbron voor Interactive Brokers.

Leren & Gemeenschap​

Boeken & Diepgaande Gidsen​

• Tracking Personal Finances using Python: Een boek dat een uitgebreide gids biedt voor het bouwen van een systeem voor persoonlijke financiën met Beancount. (Website)
• Chinese blogserie (BYVoid): Deel 1: Waarom?, Deel 2: Debet & Credit

Geselecteerde Blogberichten​

• Engels
  • Counting beans - and more - with Beancount
  • Managing Personal Finances using Python
  • No-Bullshit Beancount Introduction
• Frans
  • Beancount ou la comptabilité pour les hackers
• Chinees
  • Beancount —— 命令行复式簿记

Gemeenschap​

• Mailinglijst: Google Groups (Primair discussieforum)
• Live Chat (IRC): #beancount op web.libera.chat
• Telegram (Chinees): t.me/beancount_zh

Commerciële Diensten & Apps​

Voor gebruikers die de kracht van Beancount willen zonder zelf de infrastructuur te beheren.