# 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](https://plaintextaccounting.org/)
- **Een zachte introductie:** [Accounting for the simple minds with plain text accounting](https://dustri.org/b/accounting-for-the-simple-minds-with-plain-text-accounting.html)
- **Van web-apps naar CLI:** [Command line accounting: From mint.com to Ledger](https://muehe.org/posts/command-line-accounting/)

***

## 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.

| Bron                  | Beschrijving                                                                                                                                                                                                                       |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Beancount (Core)**  | De engine die uw grootboekbestand leest, de regels voor dubbel boekhouden afdwingt en rapporten genereert. Het biedt kern-command-line hulpprogramma's zoals `bean-check` en `bean-format`. Alle andere tools zijn hierop gebouwd. |
| **Homepage**          | [beancount.github.io](https://beancount.github.io/)                                                                                                                                                                                |
| **Broncode**          | [github.com/beancount/beancount](https://github.com/beancount/beancount)                                                                                                                                                           |
| **Documentatie**      | [GitHub Pages](https://beancount.github.io/docs/) en [Google Docs](https://docs.google.com/document/d/1RaondTJCS_IUPBHFNdT8oqFKJjVJDsfsn6JEjBG04eA/edit)                                                                           |
| **Externe bijdragen** | [Officiële lijst van community-bijdragen](https://beancount.github.io/docs/external_contributions.html)                                                                                                                            |
| **Beanquery**         | Een krachtige, SQL-achtige querytool (`v3`) voor het uitvoeren van geavanceerde queries (bijv. `SELECT ... FROM ... WHERE ...`) op uw grootboek om aangepaste analyses te genereren.                                               |

### 2. Gebruikersinterfaces

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

| Tool                       | Beschrijving                                                                                                                                                                                                          |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fava**                   | Het definitieve, volledige webdashboard voor Beancount. Het biedt interactieve grafieken, drill-down tabellen, bewerking in de browser en een uitbreidingssysteem voor het toevoegen van functies zoals budgettering. |
| **Fava-GTK**               | Een native GNOME Desktop-applicatie die Fava omhult voor een naadloze desktopervaring.                                                                                                                                |
| **Beancount Mobile**       | Een mobiele app voor gegevensinvoer om onderweg transacties toe te voegen.                                                                                                                                            |
| **Beancount Telegram Bot** | Een Telegram-bot om snel transacties aan uw grootboek toe te voegen via chat.                                                                                                                                         |

### 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.

| Tool                        | Beschrijving                                                                                                                                                           |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Beangulp (v3)**           | Het moderne, zelfstandige framework voor het bouwen van importeurs. Het verwerkt externe bestanden via Python-scripts (plug-ins) om Beancount-directives te genereren. |
| **Smart Importer**          | Een tool die importeurs versterkt met machine learning om automatisch categorieën te voorspellen en toe te wijzen.                                                     |
| **Beancount Reds Ingestor** | Een verzameling importeurs met een gedeelde bibliotheek voor het verwerken van CSV- en OFX-bestanden.                                                                  |
| **double-entry-generator**  | Een op regels gebaseerde importeur gericht op Chinese diensten zoals Alipay en WeChat Pay.                                                                             |

#### Community Importers (Per land)

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

- **China**

  - Alipay / 支付宝: [deb-sig/double-entry-generator](https://github.com/deb-sig/double-entry-generator), [wzyboy/importer](https://github.com/wzyboy/awesome-beancount/blob/master/importers/alipay_acclog.py)
  - China Merchants Bank (CMB): [Betaalpas](https://github.com/wzyboy/awesome-beancount/blob/master/importers/cmb_debit_cards.py), [Creditcard](https://github.com/wzyboy/awesome-beancount/blob/master/importers/cmb_credit_cards.py)
  - WeChat Pay / 微信支付: [deb-sig/double-entry-generator](https://github.com/deb-sig/double-entry-generator)

- **Frankrijk**

  - Caisse d'Epargne: [beancount-ce](https://github.com/ArthurFDLR/beancount-ce)
  - Boursorama, Amex: [Beancount-myTools](https://github.com/grostim/Beancount-myTools)

- **Duitsland**

  - Commerzbank: [beancount-commerzbank](https://github.com/siddhantgoel/beancount-commerzbank)
  - Deutsche Kredit Bank (DKB): [beancount-dkb](https://github.com/siddhantgoel/beancount-dkb)
  - ING: [beancount-ing](https://github.com/siddhantgoel/beancount-ing)
  - N26: [beancount-n26](https://github.com/siddhantgoel/beancount-n26)
  - Volksbank & GLS-Bank: [beancount-importer-volksbank](https://github.com/Fjanks/beancount-importer-volksbank)

- **India**
  - SBI, BOI, Paytm, HSBC, ICICI: [beancount-importers-india](https://github.com/dumbPy/beancount-importers-india)

- **Nederland**
  - ABN AMRO: [beancount-abnamro](https://github.com/deepakg/beancount-abnamro)

- **Zwitserland**

  - Algemeen: [tariochbctools](https://tariochbctools.readthedocs.io/) (BCGE, Neon, Raiffeisen, ZKB, Fidelity)
  - Finpension: [drnuke-bean](https://github.com/Dr-Nuke/drnuke-bean?tab=readme-ov-file#finpension-importer)
  - PostFinance: [tariochbctools](https://github.com/tarioch/beancounttools/blob/master/src/tariochbctools/importers/postfinance/importer.py), [drnuke-bean](https://github.com/Dr-Nuke/drnuke-bean?tab=readme-ov-file#postfinance-importer-swiss)

- **VK**

  - Monzo, Revolut, Wise: [Evernight/beancount-importers](https://github.com/Evernight/beancount-importers/)
  - Revolut, Wise: [tariochbctools](https://tariochbctools.readthedocs.io/en/latest/importers.html#revolut)

- **VS**

  - Amex, Chase, Citi, Schwab: [mterwill/gist](https://gist.github.com/mterwill/7fdcc573dc1aa158648aacd4e33786e8#file-importers-amex-py)
  - Capital One: [mtlynch/beancount-capitalone](https://github.com/mtlynch/beancount-capitalone)
  - Chase: [mtlynch/beancount-chase-bank](https://github.com/mtlynch/beancount-chase-bank), [ArthurFDLR/beancount-chase](https://github.com/ArthurFDLR/beancount-chase)
  - Clipper: [beancount-clipper](https://git.sr.ht/~goorzhel/beancount-clipper)
  - Mercury: [mtlynch/beancount-mercury](https://github.com/mtlynch/beancount-mercury)

- **Blockchain**
  - [tariochbctools](https://tariochbctools.readthedocs.io/en/latest/importers.html#blockchain)

### 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](https://marketplace.visualstudio.com/items?itemName=Lencerf.beancount)
  - [Emacs](https://github.com/beancount/beancount-mode)
  - [Vim](https://github.com/nathangrigg/vim-beancount)
  - [Zed](https://github.com/zed-extensions/beancount)
  - [Sublime Text](https://github.com/norseghost/sublime-beancount)
  - [Atom](https://atom.io/packages/beancount)
  - [Beancount Language Server](https://github.com/polarmutex/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](https://github.com/henriquebastos/gnucash-to-beancount/), [dtrai2/gc-to-bc](https://github.com/dtrai2/gnucash-to-beancount/)
  - Van Ledger/hledger: [travisdahlke/gist](https://gist.github.com/travisdahlke/71152286b0a8826249fe), [zacchiro/ledger2beancount](https://github.com/zacchiro/ledger2beancount)
  - Van YNAB: [hoostus/beancount-ynab](https://github.com/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](https://github.com/polarmutex/fava-envelope): Een Fava-extensie voor budgetteren volgens de enveloppen-methode.

- **Automatisering & Controles:**

  - [autobean.share](https://github.com/SEIAROTg/autobean/tree/master/autobean/share): Splitsen van uitgaven en schuldenbeheer.
  - [autobean.sorted](https://github.com/SEIAROTg/autobean/tree/master/autobean/sorted): Zorgt ervoor dat transacties chronologisch geordend zijn.
  - [beancount-checkclosed](https://github.com/daniel-wells/beancount_checkclosed): Controleert automatisch op een nulsaldo bij gesloten rekeningen.

- **Datamanipulatie:**

  - [autobean.narration](https://github.com/SEIAROTg/autobean/tree/master/autobean/narration): Genereert automatisch omschrijvingen voor transacties.
  - [beancount-lazy-plugins.filter\_map](https://github.com/Evernight/beancount-lazy-plugins/tree/main?tab=readme-ov-file#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](https://github.com/xuhcc/beancount-exchangerates): Voor fiat-valuta's via API's zoals `frankfurter.dev`.
- [pricehist](https://gitlab.com/chrisberkhout/pricehist): Een multi-source prijs-fetcher.
- [beancount-cryptoassets](https://github.com/xuhcc/beancount-cryptoassets): Voor het ophalen van cryptocurrency-prijzen.
- [tariochbctools](https://tariochbctools.readthedocs.io/): 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](https://personalfinancespython.com/))
- **Chinese blogserie (BYVoid):** [Deel 1: Waarom?](https://byvoid.com/zhs/blog/beancount-bookkeeping-1), [Deel 2: Debet & Credit](https://byvoid.com/zhs/blog/beancount-bookkeeping-2)

### Geselecteerde Blogberichten

- **Engels**

  - [Counting beans - and more - with Beancount](https://lwn.net/Articles/751874/)
  - [Managing Personal Finances using Python](https://sgoel.dev/posts/managing-personal-finances-using-python/)
  - [No-Bullshit Beancount Introduction](https://web.archive.org/web/20221119110728/https://blog.leononame.dev/2019/08/beancount/)

- **Frans**
  - [Beancount ou la comptabilité pour les hackers](https://cyril.deguet.com/fr/2015/09/03/beancount-comptabilite-pour-hackers/)

- **Chinees**
  - [Beancount —— 命令行复式簿记](https://wzyboy.im/post/1063.html)

### Gemeenschap

- **Mailinglijst:** [Google Groups](https://groups.google.com/g/beancount) (Primair discussieforum)
- **Live Chat (IRC):** [#beancount op web.libera.chat](https://web.libera.chat/gamja/?channels=%23beancount)
- **Telegram (Chinees):** [t.me/beancount\_zh](https://t.me/beancount_zh)

***

## Commerciële Diensten & Apps

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

| Dienst           | Beschrijving                                                                                                                                                                                                                                                                  |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Beancount.io** | Een SaaS (Software as a Service) platform dat een kant-en-klare Beancount- en Fava-instantie biedt. Het biedt ook speciale mobiele apps voor [iOS](https://apps.apple.com/app/id1527950512) en [Android](https://play.google.com/store/apps/details?id=io.beancount.android). |

## Zet platte tekst aan het werk.

Maak een Beancount-grootboek of volg de handleiding om je eigen omgeving in te richten.

[Gratis aan de slag](https://beancount.io/sign-up/?next=%2Fledger%2F) [Aan de slag](https://beancount.io/nl/docs/getting-started)

## Where to look next

- [Sitemap](https://beancount.io/sitemap.xml) - all pages with hreflang alternates
- [LLMs index](https://beancount.io/llms.txt) - curated links for AI agents (also /llms-full.txt for full docs)
- [Documentation](https://beancount.io/docs) - every doc is also available as text/markdown via .md suffix or Accept negotiation
- [REST API reference](https://beancount.io/docs/api-reference) - interactive endpoints, schemas, authentication, and code samples
- [OpenAPI spec](https://beancount.io/openapi.json) - OpenAPI 3.1 spec for this website's public content endpoints; the product contract for ledger operations is at https://beancount.io/api-gateway/v1/openapi.json
- [GraphQL](https://beancount.io/graphql) - public, read-only content API over the blog and research logs (no credentials, no ledger data): 12 query fields over 23 types
- [MCP server](https://beancount.io/mcp) - Model Context Protocol at https://beancount.io/api-gateway/mcp
