Skip to content

kendricktan/ledger-analytics

Folders and files

NameName
Last commit message
Last commit date

Latest commit

f4c6fcc · Sep 4, 2018

History

57 Commits
Aug 30, 2018
Aug 27, 2018
Aug 30, 2018
Aug 25, 2018
Aug 29, 2018
Aug 27, 2018
Sep 4, 2018
Aug 26, 2018
Aug 29, 2018
Sep 3, 2018
Aug 30, 2018
Sep 4, 2018

Repository files navigation

Ledger Analytics Build Status

Analytics/Visualization tool for ledger-cli. Tested on Node v9.11.1.

Installation and Usage

Make sure npm and ledger-cli is installed (npm --help and ledger --help should display some information if its installed).

npm install -g ledger-analytics

ledger-analytics -f <your journal file> [extra arguments for ledger]

# Examples
# ledger-analytics -f main.journal
# ledger-analytics -f main.journal --input-date-format "%d.%m.%y"

Navigate to http://127.0.0.1:3000 in your browser

Query Examples

Don't insert the $ character.

You can query multiple accounts by separating each account with a space (e.g. assets liabilities), or exclude certain accounts by adding and not <account> in front of them (e.g. expenses and not expenses:food).

Overview

$ expenses:food expenses:flights
$ assets and not assets:super and not assets:stock
$ expenses and not expenses:travel

Comparison

$ income,expenses,assets:stocks
$ expenses and not expenses:travel,income

Growth

$ assets:stocks assets:bank1
$ assets:stocks and not assets:crypto

Preview

Releases

0.1.9a (2018/09/04)

  • Fixed extraArgs bug (thanks to rohieb)
    • TODO: Write tests to accomodate for that

0.1.8a (2018/08/30)

  • Updated frontend

0.1.7a (2018/08/30)

  • Fixed growth bug #2
    • Who knew 0 || 1 gives 1?
    • undefined || 0 gives 0 too
    • Thanks JS

0.1.6a (2018/08/30)

  • Fixed growth chart bug
    • Asset is 0 if account is referenced recently (but was referenced some time ago)

0.1.5a (2018/08/30)

  • Added ability to pass extra arguments to ledger-cli
  • Timeline
    • Fixed timeline view range to exact date
    • Set date bug
  • Refactored analyze.js to ledger-api.js
    • Made ledger-api object composable :)

0.1.4a (2018/08/29)

  • Growth Chart
    • Fixed position of tooltip hover
    • Added total amont to tooltip
  • BugFixes:
    • Fixed PUBLIC_URL append on NPM build

0.1.3a (2018/08/27)

  • Added MIT LICENSE

0.1.2a (2018/08/27)

  • Bug fixes
    • Fixed index.html with weird prefix appending
    • Fixed timeline zoom sync with piechart and overview comments data

0.1.1a (2018/08/26)

  • Bug fixes
    • Fixed app crash on asset and not asset:pension

0.1.0a (2018/08/26)

  • First release of ledger-analytics
  • Basic features for data visualization

Development

Frontend

Backend

npm run start   # For frontend
npm run express # For backend

Acknowledgements

Icon by flaticon.com