What is arbtt?
arbtt is a cross-platform, completely automatic time tracker.
There are lots of time-tracking programs out there that allow you to collect statistics about how you spend your time, which activities are your biggest time-wasters, and so on. However, most of them require explicit action on your part: you have to manually enter what activity or project you're working on, and that has several disadvantages:
- You need to stop what you're doing to insert the meta-information, and that breaks your concentration;
- If you are lazy or get annoyed and don't keep updating it, the statistics will be useless
- You won't be able to catch a little thing like quickly answering an e-mail or looking for the weather report.
arbtt, on the other hand, is a time tracker that gets out of the way.
Its core component (arbtt-capture
) silently captures data
about what you are doing, completely autonomously.
No interaction required, no distraction possible.
This information is continuously stored in a log file.
A separate tool (arbtt-stats
) the allows you to investigate this data,
at whatever time is convenient to you, by using simple text-based rules.
One big advantage of this approach is that you do not need to know in advance what queries you are interested in. Since the rules are applied in real-time when you are evaluating your data, and not when recording it, your raw data is always intact, and you can add more rules and forgotten special cases later.
Keep in mind that the log file might contain very sensitive private data. Make sure you protect it well.
You can get rid of all logs by deleting~/.arbtt/capture.log
.
How does it work?
arbtt-capture
is a desktop daemon that runs in the background
and keeps a continuous log of your activity,
by storing at regular intervals which windows are open,
which one has the focus and how long it has been since your last action.
From this log, a wealth of statistics can be derived.
Here's where the "rule-based" part of the name comes along:
arbtt comes with a built-in command-line statistics generator (arbtt-stats
)
that will, based on very simple but powerful rules you can customize,
sift through the raw data and reveal patterns and relevant information.
The rules are specified in a simple text-based format, on a file called "categorize.cfg". Here's an example of a simple categorize.cfg file:
--Convert program executable names to recognizable names aliases ( "Navigator" -> "Firefox", "evince" -> "PDF reader", "gedit" -> "Text editor", "totem" -> "Video player", ) { --Mark any samples captured after 5 minutes of inactivity with the "inactive" tag $idle > 300 ==> tag inactive, --Tag each program with its executable name (filtered by the aliases above) tag Program:$current.program, --Tag each program with its window title (filtered by the aliases above) tag Title:$current.title, $time >= 8:00 && $time < 12:00 ==> tag time-of-day:morning, $time >= 14:00 && $time < 18:00 ==> tag time-of-day:afternoon, }
And here's the corresponding output of arbtt-stats -c "Program"
:
Statistics for category "Program" ================================= __________________Tag_|_________Time_|_Percentage_ Program:Firefox | 8d06h20m00s | 49.01 Program:Google Chrome | 3d15h24m00s | 21.60 Program:Text editor | 1d04h04m00s | 6.94 Program:Skype | 13h55m00s | 3.44 Program:Terminal | 9h22m00s | 2.31 Program:PDF reader | 6h10m00s | 1.52 Program:Desktop | 5h13m00s | 1.29 Program:File browser | 4h11m00s | 1.03 (53 entries omitted) | 22h59m00s | 5.68
Install arbtt
Binary installations
-
Debian/Ubuntu:
arbtt is available both in Debian's and Ubuntu's repositories.
Install arbtt:
sudo apt-get install arbtt
Set it up to start automatically on system startup:
cp /usr/share/doc/arbtt/examples/arbtt-capture.desktop ~/.config/autostart/
Start the daemon manually, if you want it to start capturing immediately, rather than at the next system restart:
(arbtt-capture &)
Create a minimal categorize.cfg file to allow arbtt-stats to be invoked without errors:
echo "{\$idle > 60 ==> tag inactive}" > ~/.arbtt/categorize.cfg
-
NixOS:
arbtt can be enabled in your NixOS configuration via
services.arbtt.enable
, see the NixOS module for more configuration settings. -
Windows:
Download the latest arbtt-setup.exe and follow the setup process as usual. This will set up the capturing daemon, but note that there is no graphical interface. Extracting stats from the data requires running arbtt-stats on the command line. Runarbtt-stats --help
for a quick reference; for more detailed information, consult the manual.
Source installations
arbtt depends on several libraries whose development versions (name often suffixed -dev
) must be available or the compilation
may fail with errors such as X11-1.6.1.2 failed during the configure step
;
these libraries include:
- X11, for the X11 Haskell binding (possibly named
libx11-dev
orxorg-dev
in your package manager) - PCRE3, for pcre-light (possibly
libpcre3-dev
) - XSS, for arbtt (possibly
libxss-dev
)
Fetch the latest revision using
git clone https://github.com/nomeata/arbtt
and run the following command to build the arbtt binaries:
cabal install --installdir=bin --install-method=copy --overwrite-policy=always
You will now find the binaries in the bin
subdirectory, which you can copy, for example, to
/usr/local/bin
.
If you use GNOME or KDE, you can copy the file "arbtt-capture.desktop"
to ~/.config/autostart/
. If you didn't do a system-wide installation,
you'll probably need to put the full path to arbtt-capture
in the Exec line of the .desktop file.
Mac OS X installation
arbtt can run on Mac OS X systems. To compile it, you need to install the pkgconfig and pcre source packages using Homebrew or MacPorts. For Homebrew, you can execute:
brew install pkgconfig
brew install pcre
or for MacPorts:
sudo port install pkgconfig
sudo port install pcre
Then, you can compile arbtt using the usual cabal command, as described above.
If you use MacPorts and have a linking error, it may be because of a conflict between the system libiconv and the MacPorts libiconv. Execute the following cabal command to resolve the conflict:
cabal configure --extra-lib-dir=/usr/lib
Get in touch
Mailing list
The main communication channel is the arbtt mailing list,
arbtt@lists.nomeata.de
, which is used for both users and
developers of arbtt. If you have questions about arbtt, want to report bugs, or
just share your experience with it, please join. Also any contributions in the
form of ideas, code or documentation is highly appreciated. To subscribe to it,
visit the mailinglist page.
Issue tracker
In addition to the mailing list, we use the issue tracker of the GitHub repository.
Developement repository
The source code is written in Haskell, hosted on GitHub.
History and credits
Arbtt was created in 2009 by Joachim Breitner. This webpage was designed by Waldir Pimenta in 2013. The background image is Revolutionstaschenuhr by Onnahfarg; CC-BY
.