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:
New features in 1.0
See this short walkthrough for what's new: https://youtu.be/BlLmtZUEULU
org-analyzer should run on all platforms that can run JAVA — but you will need to have that installed.
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.
(require 'package) (add-to-list 'package-archives '("melpa" . "http://melpa.org/packages/"))
(package-install "org-analyzer"). Afterwards, you can start the tool
Download the latest jar as described above and start it with
java -jar org-analyzer-1.0.4.jar.
The following command line options are available, as per
java -jar org-analyzer-1.0.4.jar --help:
Usage: java -jar org-analyzer-1.0.4.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.
To play around with the codebase you will need to have Clojure installed.
To just run the app from source do a
git clone https://github.com/rksm/clj-org-analyzer and then
make http-server. Then visit http://localhost:8090.
You can run the server-side tests via
To work interactively, I would recommend an editor / IDE that uses nREPL, I personally use Emacs with cider. Start an nREPL server with
make nrepl (this will also start an http-server) and then connect to localhost:7888 for a Clojure session and to localhost:7889 for a ClojureScript session.
If you don't use an nREPL enabled editor you can still run a figwheel repl via
Whe running with nREPL or figwheel you will get an additional page for UI experiments and tests: http://localhost:8090/expts.html