hledger finance repo

In this repo we keep a ledger and reports of the hledger project's finances, for clarity and dogfooding.
See also the hledger.org Project finances page.

In this directory:

• Justfile - maintenance and reporting scripts. Run just to see help.
• hledger.conf - local hledger config
• main.journal - top-level journal file
• accounts.journal - account declarations
• oc.csv - all hledger open collective transactions, exported as CSV
• oc.csv.rules - hledger CSV rules for converting the above to..
• oc.journal - journal file generated from oc.csv
• other.journal - other transactions, manually recorded
• README.md - this readme. Hand-maintained content plus hledger-generated reports.

Reports update process:

• View latest Open Collective transactions
• Check parameters 1
  • all should be set to All
• Click Download CSV
• Check parameters 2
  • Date range should be sufficient to leave no gap
  • Timezone should be what rules require: Local (consider switching to UTC for greater stability)
  • Start date / End date should be sufficient to leave no gap (Why both these and Date range ? Try ignoring these)
  • Exported Fields should be Platform Default
  • Separate transactions compatibility should be ENABLED
• Click Export CSV
• Wait for and check for a successful complete download by browser. Warning this is deceptive.
• Manually close the Export CSV dialog
• In finance dir, just update (gather csv, regenerate journal and reports)
• Deal with any snafu (missing python deps..)
• Review diffs in magit, investigate/resolve any problems
• Review reports in VSC markdown preview, check that these match:
  • Assets report > latest asset balance
  • https://opencollective.com/hledger#category-BUDGET > TODAY'S BALANCE
• Commit
• git push to update https://github.com/simonmichael/hledger_finance

Reports

Revenues & Expenses This Year

account	revenues:donations	expenses:fees	Total:
commodity	USD	USD	USD
2025-01	141.00	-24.08	116.92
2025-02	37.00	-7.79	29.21
total	178.00	-31.87	146.13
average	89.00	-15.94	73.06

Revenues & Expenses by Year

account	revenues:donations	expenses:bounties	expenses:fees	expenses:misc	Total:
commodity	USD	USD	USD	USD	USD
2017	120.00	0	-19.08	0	100.92
2018	225.00	0	-34.93	0	190.07
2019	105.00	0	-23.33	0	81.67
2020	1254.38	0	-189.81	0	1064.57
2021	4721.00	-760.01	-708.34	0	3252.65
2022	3744.00	-400.00	-592.10	-578.12	2173.78
2023	1868.00	-862.00	-303.93	-100.00	602.07
2024	1277.00	-1198.14	-171.89	0	-93.03
2025	178.00	0	-31.87	0	146.13
total	13492.38	-3220.15	-2075.28	-678.12	7518.83

Assets & Liabilities By Year

account	assets:opencollective	Total:
commodity	USD	USD
2017	100.92	100.92
2018	290.99	290.99
2019	372.66	372.66
2020	1437.23	1437.23
2021	4689.88	4689.88
2022	6863.66	6863.66
2023	7465.73	7465.73
2024	7372.70	7372.70
2025	7518.83	7518.83