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 (settings: Date range: All time, or whatever; Timezone: Local or UTC, doesn't matter; Exported Fields: Platform Default; Separate transactions compatibility: off )
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 | 7388.46 | 7388.46 |
| 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 | 1232.00 | -1148.93 | -160.34 | 0 | -77.27 |
| total | 13269.38 | -3170.94 | -2031.86 | -678.12 | 7388.46 |
| Commodity | 2024-01-01..2024-11-18 | |
|---|---|---|
| Revenues | ||
| donations | USD | 1232.00 |
| October Swimmer | USD | 290.00 |
| Joyful Systems | USD | 160.00 |
| Bas van Dijk | USD | 100.00 |
| Marc | USD | 100.00 |
| usaAmch | USD | 100.00 |
| Jack Todaro | USD | 55.00 |
| GLakovnik | USD | 50.00 |
| akanshaG42 | USD | 50.00 |
| incognito | USD | 50.00 |
| ishmaelavila | USD | 50.00 |
| markokocic | USD | 50.00 |
| Brandon Barker | USD | 22.00 |
| Frank | USD | 22.00 |
| James Blachly | USD | 22.00 |
| Ken Ewing | USD | 22.00 |
| Rishi Hyanki | USD | 22.00 |
| Samim Pezeshki | USD | 22.00 |
| Guest | USD | 20.00 |
| Richard Kelly | USD | 20.00 |
| doppy1988 | USD | 5.00 |
| Total: | USD | 1232.00 |
| Expenses | ||
| bounties | USD | 1148.93 |
| Simon Michael | USD | 400.00 |
| Thielemann | USD | 149.16 |
| Bas van Dijk | USD | 100.00 |
| usaAmch | USD | 100.00 |
| GLakovnik | USD | 50.00 |
| Pranesh Prakash | USD | 50.00 |
| William Pierce | USD | 50.00 |
| akanshaG42 | USD | 50.00 |
| ishmaelavila | USD | 50.00 |
| lakshayg | USD | 50.00 |
| markokocic | USD | 50.00 |
| Ivan Popovych | USD | 49.77 |
| fees | USD | 160.34 |
| Open Source Collective | USD | 82.04 |
| STRIPE | USD | 54.35 |
| PAYPAL | USD | 20.24 |
| WISE | USD | 3.71 |
| Total: | USD | 1309.27 |
| Net: | USD | -77.27 |
2017 101
2018 190 +
2019 82
2020 1065 +++++++
2021 3253 +++++++++++++++++++++
2022 2174 ++++++++++++++
2023 602 ++++
2024 -77
2017 101
2018 291 +
2019 373 ++
2020 1437 +++++++++
2021 4690 +++++++++++++++++++++++++++++++
2022 6864 +++++++++++++++++++++++++++++++++++++++++++++
2023 7466 +++++++++++++++++++++++++++++++++++++++++++++++++
2024 7388 +++++++++++++++++++++++++++++++++++++++++++++++++
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
⢰⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⣒⡒⠒⠒⠒⠒⢲
600 ⢹ ⠠⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤ ⣠⡀ ⡇⡇ ⢸
⢸ expenses ⡇⡇ ⡇⡇ ⢸
⢸ ⡇⡇ ⡇⡇ ⢸
⢸ ⡇⡇ ⡇⡇ ⢸
400 ⢹ ⢰⢲ ⡇⡇ ⡇⡇ ⢸
⢸ ⢸⢸ ⡇⡇ ⢠⢶ ⡤⠇⡇ ⢸
⢸ ⢸⢸ ⢰⠛⡆ ⡇⡇ ⢸⢸ ⡇ ⡇ ⢸
[USD] ⣸ ⢠⠼⢸ ⢸⡀⡇ ⡇⡇ ⡖⡆ ⣰⢲ ⢸⢸ ⡇ ⡇ ⢸
200 ⢸ ⢸ ⢸⢠⠼ ⡇⡖⡆ ⡇⡇ ⡇⡇ ⢸⢸ ⢸⢸⢠⠶⡄ ⡇ ⡇ ⢸
⢸ ⢸ ⢸⢸ ⡇⡇⡇ ⡇⠙⡆ ⡇⡇ ⡔⢲ ⢰⠊⠘⢲ ⢸⠘⠚⠠⣇⡀⢀⡤⡀ ⡇ ⠧ ⢸
⢸ ⢀⣄⢀⣀⢠⠤⠼ ⠘⠚ ⠲⠃⣇⠏⠁ ⠧⠤⡄⡇⡇ ⠇⢸⡀⢸ ⢸ ⢸ ⢸⡇⢸ ⡇ ⡇ ⢸
⣸ ⣠⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣠⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣠⢤⣄⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣠⣀⣀⡴⠒⠒⠒⠒⠒⠒⠒⠚⠁⠘⠚⠈⠉ ⠈⠁⠑⠚⠉ ⠙⠊ ⠈⠓⠒⠓⠚ ⠈⠓⠼ ⠧⠤⠤⠤⠇ ⢸
0 ⠘⠒⠒⠒⠂⠶⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠶⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠰⠆⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠰⠆⠒⠘
2017 2018 2019 2020 2021 2022 2023 2024 2025