/ledger-charts

A web app for generating pretty charts out of ledgers data

Primary LanguageJavaScript

ledger-charts - generate fancy charts out of your ledger data

ledger-charts is a web app to generate charts out of your ledger data. It uses ledger-rest to access the data.

Charting is done via HighCharts, also uses jQuery and Twitter Bootstrap.

It supports balance, budget and register reports as well as most chart typesHighCharts provides. An exception are pie charts, because the current implementation doesn't provide useful data layouts for those.

Installation instructions

  • Install ledger

  • Install ruby

  • Install the following ruby gems:

    gem install git
    gem install haml
    gem install rack
    gem install sinatra
    gem install thin
    gem install escape
    
  • Install ledger-charts in a folder next to ledger-rest:

    mkdir ledger; cd ledger
    git clone https://github.com/profmaad/ledger-rest.git
    git clone https://github.com/profmaad/ledger-charts.git
    
  • Create a git repository with a ledger file

    mkdir ledger-data; cd ledger-data
    git init
    echo "2013/05/03 Test transation" >> ledger.ledger
    echo "  expenses:car 12" >> ledger.ledger
    echo "  assets:cash" >> ledger.ledger
    git add ledger.ledger
    git commit -m 'Initial ledger file'
    cd ..
    
  • Create a config file ledger-charts/ledger-rest.yml, containing the following (adapt to your setup, of course):

    ledger_bin: "/usr/local/bin/ledger"
    ledger_file: "/path/to/your/ledger.ledger"
    
  • Start the webserver to run both ledger-charts and ledger-rest:

    cd ledger-charts
    thin -R both.ru -eproduction --threaded start