sriharshamadala / FreshbooksVizualization

Visualize your time tracking data on Freshbooks using an interactive timeline.

Description

This project lets you visualize your time tracking data from Freshbooks on a nice and intuitive timeline. We use python API for Freshbooks and Google visualization as submodules to keep track of any changes in the future.

Setup

Clone this project to your local computer at a desired location:

$ git clone https://github.com/sriharshamadala/FreshbooksVizualization.git
$ cd FreshbooksVizualization

Method 1

We have two submodules, one for the freshbooks API and the other for google visualization API. To update them:

$ git submodule update --init --recursive

since the freshbooks API does not have __init__.py it cannot be imported as a module. Hence create an empty __init__.py file inside the submodule using any choice of your editor. Make sure this file is created, otherwise you will see an import error.

$ vim FreshbooksPython/__init__.py

Execute our main python script by passing the <api_url> (do not use the entire url, just company_name.freshbooks.com) and the <authentication_token> as the arguments. You can find them in your freshbooks website under profile:

$ python MyFreshbooks.py api_url auth_token > timeline.html

Open timeline.html in your browser to visulaize your freshbooks data. Hover over any project to see more details.

Method 2

Execute the shell script setup.sh by passing the <api_url> (do not use the entire url, just company_name.freshbooks.com) and the <authentication_token> as the arguments. You can find them in your freshbooks website under profile, which basically does everything in Method 1.

$ setup.sh api_url auth_token timeline.html

If the shell script fails to generate the output follow Method 1.

Note:

• Tasks performed on weekends are highlighted in red.
• Each task description is preceeded by the number of hours spent on that particular task. The format is hours.minutes. minutes are normalized to 100.

For any issues with executing the script or feature requests please create an issue here.