Here we track the hledger project's finances, for clarity, dogfooding, and as a real-world example of FOSS project accounting with hledger. (shortcut: https://finance.hledger.org)
See also the FINANCE section on the hledger website, eg Sponsor hledger, Regression bounty and FINANCE notes.
In this directory:
Justfile- maintenance and reporting scripts.justto see help.hledger.conf- local hledger configmain.journal- top-level journal fileaccounts.journal- account declarationsoc.*- hledger open collective CSV, conversion rules, journalother.journal- other transactions, manually recorded
The rest of this README is reports, intended to be somewhat readable on Github. These are regenerated semi-automatically, and may improve as data and scripts are cleaned up.
Update process:
- View latest OC transactions with all kinds selected: https://opencollective.com/hledger/transactions?kind=CONTRIBUTION%2CEXPENSE%2CHOST_FEE%2CPAYMENT_PROCESSOR_FEE%2CPAYMENT_PROCESSOR_COVER
- click Download CSV; click Export CSV
just updateto gather the csv, regenerate and check journals, and update reports- Review changes, investigate/resolve any issues, commit
- Check that the latest net asset balance matches https://opencollective.com/hledger#category-BUDGET > TODAY'S BALANCE
git pushto update https://github.com/simonmichael/hledger_finance
| 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 | 7557.01 | 7557.01 |
| total |
| 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 | 1091.00 | -849.77 | -149.95 | 0 | 91.28 |
| total | 13128.38 | -2871.78 | -2021.47 | -678.12 | 7557.01 |
| Commodity | 2024-01-01..2024-10-15 | |
|---|---|---|
| Revenues | ||
| donations | USD | 1091.00 |
| October Swimmer | USD | 280.00 |
| Joyful Systems | USD | 150.00 |
| Bas van Dijk | USD | 100.00 |
| Marc | USD | 100.00 |
| usaAmch | USD | 100.00 |
| Jack Todaro | USD | 50.00 |
| akanshaG42 | USD | 50.00 |
| incognito | USD | 50.00 |
| markokocic | USD | 50.00 |
| Brandon Barker | USD | 20.00 |
| Frank | USD | 20.00 |
| James Blachly | USD | 20.00 |
| Ken Ewing | USD | 20.00 |
| Rishi Hyanki | USD | 20.00 |
| Samim Pezeshki | USD | 20.00 |
| Guest | USD | 18.00 |
| Richard Kelly | USD | 18.00 |
| doppy1988 | USD | 5.00 |
| Total: | USD | 1091.00 |
| Expenses | ||
| bounties | USD | 849.77 |
| Simon Michael | USD | 400.00 |
| Bas van Dijk | USD | 100.00 |
| usaAmch | USD | 100.00 |
| Pranesh Prakash | USD | 50.00 |
| William Pierce | USD | 50.00 |
| akanshaG42 | USD | 50.00 |
| markokocic | USD | 50.00 |
| Ivan Popovych | USD | 49.77 |
| fees | USD | 149.95 |
| Open Source Collective | USD | 77.94 |
| Stripe | USD | 50.85 |
| PayPal | USD | 18.25 |
| Other Payment Processor | USD | 2.91 |
| Total: | USD | 999.72 |
| Net: | USD | 91.28 |
2017 101
2018 190 +
2019 82
2020 1065 +++++++
2021 3253 +++++++++++++++++++++
2022 2174 ++++++++++++++
2023 602 ++++
2024 91
2017 101
2018 291 +
2019 373 ++
2020 1437 +++++++++
2021 4690 +++++++++++++++++++++++++++++++
2022 6864 +++++++++++++++++++++++++++++++++++++++++++++
2023 7466 +++++++++++++++++++++++++++++++++++++++++++++++++
2024 7557 ++++++++++++++++++++++++++++++++++++++++++++++++++
hledger assets
bal --depth=1 ^assets --historical
⢰⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⢒⣒⣒⣒⣒⣒⣒⣒⣒⠒⠒⠒⠒⢲
8000 ⢸ ⠠⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤ ⢀⣀ ⣀⡤⠴⠒⠳⠤⠦⠏⠉⠉⠉⠉⠉⠁ ⠙ ⢸
⢸ assets ⣠⣀⡠⠴⠶⠚⠉⠈⠉⠉ ⢸
⢸ ⣀ ⣀⡔⠋ ⠁ ⢸
6000 ⢸ ⢀⡔⠻⠟⠁ ⢸
⢸ ⢀⡔⠋ ⢸
⢸ ⣠⡶⠋ ⢸
4000 ⢸ ⣀⣤⠞⠁ ⢸
[USD] ⢸ ⣠⠚ ⢸
⢸ ⢀⡴⠚⠁ ⢸
2000 ⢸ ⣀⡤⠚⠉ ⢸
⢸ ⢀⣀⡤⠴⠒⠚⠉⠁ ⢸
⢸ ⢀⣀⣀⣀⣀⣀⣠⣤⣤⣤⣤⣤⣤⠤⠤⠤⠤⠤⠤⠤⠤⠴⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠛⠚⠉⠉⠉ ⢸
0 ⠘⠂⠒⠒⠲⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠰⠆⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠰⠆⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠰⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠒⠘
2017 2018 2019 2020 2021 2022 2023 2024 2025
hledger monthly revenues
bal --depth=1 ^revenues --monthly
⢰⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⢒⣒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⢲
⢸ ⢸⢸ ⢰⢲ ⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤ ⢸
⢸ ⢠⢦⢸⢸⢠⢲⢸⢸ revenues ⢸
⢸ ⡤⠤⠤⠞⠋⠘⠚⠘⠚⢸⢸⠘⢦ ⢸
400 ⢺ ⡇ ⢸⢸ ⢸ ⢀⠤⡀ ⢠⢤ ⢸
⢸ ⡤⡄⡤⡄⡇ ⠸⠼ ⠸⠤⠴ ⡇ ⢸⢸ ⢸
⢸ ⡇⡇⡇⡇⡇ ⡇ ⢸⢸ ⢸
⢸ ⡖⠃⡇⡇⢧⠇ ⣇⡀ ⢸⢸ ⡤⡄ ⢸
[USD] ⢼ ⡇ ⡇⡇ ⡇ ⡎⡇ ⢸⢸⠄ ⡇⡇ ⢸
⢸ ⣀ ⢀⡇ ⣇⡇ ⠓⠒⠚⠒⠃⠧⠤⠤⠤⠞⠹⠜⢹ ⢸⠉⢸⡀ ⡇⡇ ⢸
⢸ ⢰⠚⠈⠒⠒⠒⠒⠋⠉ ⠈ ⠈⠉⠉⠉ ⢨⡇ ⡇⣇ ⢸
⢸ ⢠⠖⡄ ⢸ ⠸⣃⣀⣀⣀⣀⣀⡇ ⢸
⣸ ⠠⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠴⠒⠒⠒⠒⠲⠤⠤⠤⠼ ⠧⠤⣄⣤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠼ ⢸
0 ⠘⠒⠒⠒⠂⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠆⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠆⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠰⠆⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠆⠘
2017 2018 2019 2020 2021 2022 2023 2024 2025
hledger monthly expenses
bal --depth=1 ^expenses --monthly
⢰⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⢒⣒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⢲
⢸ ⢸⢸ ⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠄ ⢸
⢸ ⢸⢸ expenses ⢸
⢸ ⢸⢸ ⢸
400 ⢺ ⣠⣄ ⢸⢸ ⡞ ⢸
⢸ ⡇⢸ ⢸⢸ ⡇ ⢸
⢸ ⡇⢸ ⢀⣀ ⢸⢸ ⢸⢹ ⡞⠁ ⢸
⢸ ⡇⢸ ⢸⢸ ⢸⢸ ⣀ ⢸⢸ ⡇ ⢸
[USD] ⢼ ⡖⠃⢸ ⢸⢸ ⢸⢸ ⡏⡇ ⡯⢵ ⢸⢸ ⡇ ⢸
200 ⢸ ⡇ ⢸⢰⠚⢸⢰⢹ ⢸⢸⡀ ⡇⡇ ⡇⢸ ⢸⢸⢰⢳ ⡇ ⢸
⢸ ⡇ ⢸⢸ ⢸⢸⢸ ⢸ ⢹ ⡇⡇ ⡏⡇ ⡎⠁⠈⢳ ⢸⠈⠚⠸⢤ ⠤⡄ ⡇ ⢸
⢸ ⣠⡀⣀⡀⡴⠶⠃ ⠘⠚ ⠘⠚⠸⠼⠉ ⠘⠤⠶⣀⡇⡇ ⡇⢧⡀⡇ ⢸ ⢸ ⢸ ⡇⡇ ⡇ ⢸
⣸ ⣠⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣄⣀⣀⣀⣀⣀⣀⣀⣀⣀⣠⠤⣤⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣄⣀⣠⠖⠒⠒⠒⠒⠒⠒⠒⠋ ⠓⠃⠈ ⠉ ⠙⠉⠁ ⠓⠃ ⠈⠓⠒⠓⠚ ⠘⠒⠤⠃⠧⠤⠤⠤⠇ ⢸
0 ⠘⠒⠒⠒⠂⠶⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠰⠆⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠆⠘
2017 2018 2019 2020 2021 2022 2023 2024 2025