Aller au contenu principal

Envelope Budgeting Example — beancount.io

A Beancount ledger demonstrating envelope (zero-based) budgeting: giving every dollar a job before it is spent, and seeing immediately when a category runs dry. Notes du grand livre

mars 2026
Dernière écriture le 31 mars 2026 (il y a 7 mois)
Données par période
PériodePatrimoine netRevenusDépensesBénéfice net
2026-01-3112 825,74 USD4 100,00 USD2 474,26 USD1 625,74 USD
2026-02-2815 275,74 USD4 100,00 USD1 650,00 USD2 450,00 USD
2026-03-3118 775,74 USD4 100,00 USD600,00 USD3 500,00 USD

Situation financière31 mars 2026

Patrimoine net

18 775,74 USD

+3 500,00 USD · +22,9 %depuis le mois précédent

Actifs

18 775,74 USD

Passifs

—

Aucune dette

Mouvements d'argentmars 2026

Entrées d'argent

4 100,00 USD

Moyenne sur 2 mois4 100,00 USD

Principales sources

Sorties d'argent

600,00 USD

Moyenne sur 2 mois2 062,13 USD71 % en dessous

Principales dépenses

Flux de trésorerie

Chargement des rôles des comptes…

Activité récente

31 mars

14 mars

5 mars

5 févr.

2 févr.

README.md

Envelope Budgeting Example — beancount.io

A Beancount ledger demonstrating envelope (zero-based) budgeting: giving every dollar a job before it is spent, and seeing immediately when a category runs dry.

The method rests on one idea — envelopes are equity, not assets. The money is already in the bank; budgeting only decides what it is promised to. So an allocation moves value between equity subaccounts and never touches Assets, which is why the overlay can never disturb your bank reconciliation.

The ledger also declares matching native custom "budget" targets for each expense account. The equity postings provide rollover envelope balances; the custom directives power beancount.io's Budget report and its budget-versus-actual charts. They are complementary views of the same monthly plan.

Quick Start

bash
make install   # Install beancount + fava via uv
make check     # Verify the ledger has zero errors
make serve     # Open Fava at http://localhost:4739

File Guide

FileWhat it demonstrates
main.beanEntry point — options and include directives
accounts.beanCommodity definitions, real accounts, and the envelope tree
budgets.beanNative monthly targets used by the beancount.io Budget report
transactions/opening.beanStarting balances, and what "to be budgeted" means
transactions/funding.beanAssigning income to envelopes — kept separate from income arriving
transactions/spending.beanThe four-posting purchase: two for the money, two for the plan
transactions/overspending.beanAn envelope going negative, and covering it deliberately
transactions/sinking-funds.beanFunding an irregular bill monthly instead of being surprised by it
transactions/reset.beanRetiring a category, and reconciling against the bank

The one thing to copy

Spending is four postings, readable as two independent pairs:

beancount
2026-01-08 * "Whole Foods" "Weekly shop"
  Assets:Bank:Checking       -128.44 USD   ; what your bank sees
  Expenses:Groceries          128.44 USD
  Equity:Budget:Groceries    -128.44 USD   ; what your budget sees
  Equity:Budget:Unallocated   128.44 USD

Each pair balances on its own, so the budget overlay is always safe to add, remove, or ignore.