Table of Contents
Abstract
arbtt is a background daemon that stores which windows are open, which one has the focus and how long since your last action (and possibly more sources later), and stores this. It is also a program that will, based on expressive rules you specify, derive what you were doing, and what for.
It is comparable to the window trackers RescueTime, selfspy, TimeSnapper, and Productive Peach; but it differs from the manual timetrackers like Project Hamster which require the user to type a description of their activities.
The log file might contain very sensitive private data. Make sure you understand the consequences of a full-time logger and be careful with this data.
See the project website for installation instructions.
To have arbtt gather useful data, you need to make sure that
arbtt-capture is started with your X session. If you use
GNOME or KDE, you can copy the file
arbtt-capture.desktop to
~/.config/autostart/. You might need to put the full
path to arbtt-capture in the Exec line there, if you did
not do a system wide installation.
By default, arbtt-capture will save one data sample per
minute. If you want to change that, you can pass --sample-rate
to arbtt-capture, where
RATERATE specifies the sample rate in seconds.
Obviously, you can already read the documentation. If you still want to
build it yourself, enter the directory doc/ and run
make for the documentation in HTML and PDF format.
If you want to try the latest unreleased state of the code, or want to contribute to arbtt, you can fetch the code with
darcs get http://darcs.nomeata.de/arbtt