Skip to content
Fun with org data
Clojure CSS Emacs Lisp Makefile HTML
Branch: master
Clone or download
Latest commit 53eccdf Aug 15, 2019

README.md

org-analyzer

org-analyzer creates an interactive visualization of org-mode time-tracking data. org-mode allows to add start/end timestamps to org-mode items (via org-clock-in) to capture the times spend working on particular things. Unfortunately the reporting features built into org-mode are rather limited. This tool remedies that by providing a visual and interactive presentation of time tracking data.

In other words, org-analyzer converts something like this

* current projects
** org clockin visualization
*** ui - improvements (tags, filter, day viz)
:LOGBOOK:
CLOCK: [2019-08-04 Sun 23:35]--[2019-08-04 Sun 23:49] =>  0:14
CLOCK: [2019-08-04 Sun 13:51]--[2019-08-04 Sun 15:06] =>  1:15
CLOCK: [2019-08-04 Sun 04:25]--[2019-08-04 Sun 05:16] =>  0:51
...
:END:

into something like this:

Usage

org-analyzer should run on all platforms that can run JAVA — but you will need to have that installed.

Standalone

Download the latest jar file and run it! (double click or from command line, see below). It will open a new browser window, if you close it the server will stop in a few seconds.

Emacs

2019-08-13: MELPA package is pending, see the melpa pull request.

For the time being, emacs support can be enabled by downloading the emacs package directly, extracting it and adding it to your load path and require it:

(add-to-list 'load-path "/path/to/org-analyzer-0.3.3/")
(require 'org-analyzer)

Afterwards, you can start the tool via M-x org-analyzer-start.

Commandline

Download the latest jar as described above and start it with java -jar org-analyzer-0.3.3.jar.

The following command line options are available, as per java -jar org-analyzer-0.3.3.jar --help:

Usage: java -jar org-analyzer-0.3.3.jar [opt*] [org-file-or-dir*]

Interactive visualization of timetracking data (org clocks).

This command starts an HTTP server that serves a web page that visualizes the
time data found in org files. Org files can be specified individually or, when
passing a directory, a recursive search for .org files is done. If nothing is
specified, defaults to the current directory, recursively searching it for any
.org file.

opts:
     --host hostname	Sets hostname, default is localhost
 -p, --port portnumber	Sets port, default is 8090
     --dontopen		Don't automatically open a web browser window

For more info see https://github.com/rksm/cljs-org-analyzer.

License

GPLv3

You can’t perform that action at this time.