11

org analyzer: interactive visualizations of time tracking data for org mode

 4 years ago
source link: https://www.tuicool.com/articles/MNve63N
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

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:

Jn2qEb6.png!web

New features in 1.0

See this short walkthrough for what's new: https://youtu.be/BlLmtZUEULU

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

org-analyzer is on. Make sure MELPA is in your package-archives :

(require 'package)
(add-to-list 'package-archives '("melpa" . "http://melpa.org/packages/"))

Then run (package-install "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-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.

Hacking

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 make test .

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 make figwheel .

Whe running with nREPL or figwheel you will get an additional page for UI experiments and tests: http://localhost:8090/expts.html

License

GPLv3


About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK