Release Notes

The version history with changes relevant for the user is documented here.

Version 0.12

  • Improved timezone handling

  • Empty logfiles no longer crash arbtt-stats, thanks to Tomáš Janoušek

  • New option --first for arbtt-dump, thanks to Tomáš Janoušek.

Version 0.11.1

  • Support building with GHC-9.0

Version 0.11

  • Support for the $hidden and $wdesktop variables in the configuration file, thanks to Tomáš Janoušek.

  • The --filter option of arbtt-stats is greatly sped up, thanks to Tomáš Janoušek.

Version 0.10.4

  • Support symlinks for ~/.arbtt/capture.log

Version 0.10.3

  • Fix build issues with Cabal.

Version 0.10.2

  • The category report now also has an entry (total time), especially useful with --for-each.

  • Support for GHC-8.0 and older has been dropped.

Version 0.10.1

  • Rodney Lorrimar contributed fixed to build against newer versions of dependencies.

  • Michal J. Gajda ensured that intervals are also printed as local times.

Version 0.10

  • Markus Hauck contributed the != operator, the $now variable and the condition construct (as well as other code cleanup).

  • The development repository migrated from darcs to git.

  • The command arbtt-import now supports reading JSON records, and can be used to append to an exising log file in a steaming fasion.

Version 0.9

Version 0.8.1

  • The syntax now allows for time differences larger than 99:99. (issue #69)

Version 0.8

  • arbtt-dump can now show the data in other formats as well, as suggested by Waldir Pimenta (option --format). This includes a human-readale output and JSON.

  • New option --last of arbtt-dump.

  • arbtt-recover can handle larger datasets with a reasonable amount of memory.

  • When dumping samples with arbtt-stats or arbtt-dump (in human-readable mode), times are printed in the local time zone, as suggested by Oren Gampel.

  • arbtt-capture now supports the option --dump for development and debugging purposes.

  • The name of the current desktop (or workspace) is also recorded, and available as $desktop (issue #56).

  • Two bugs in the parser were fixed (issue #59 and issue #60).

  • arbtt-stats can print reports split by time interval, using the --for-each option.

  • arbtt-stats can print the actual samples selected, with --dump-samples.

  • Support for GHC-7.8 was added, with help from Jayesh Kumar Gupta (issue #63).

  • Arbtt now has a proper testsuite integrated into Cabal, and an automated test infrastructure on Travis.

  • Waldir Pimenta contributed a new web page, hosted at

Version 0.7

  • Make sure that the log file is only readable by the current user. Thanks to Joey Hess for pointing that out.

  • Show a progress bar in arbtt-stats.

  • GHC-7.6 compatibility, thanks to Isaac Dupree.


  • Added missing module to the packages.

Version 0.6.4

Version 0.6.3

  • Performance improvements.

  • Support comparing a string to a list of strings, or matching it against a list ofregular expressions.

Version 0.6.2

  • Add a warning whtn the system locale is not supported.

  • Allwo RTS options to be passed to the arbtt binaries.

  • GHC 7.4 compatibility.

Version 0.6.1

  • Performance improvements.

Version 0.6

  • The command arbtt-capture now supports the --logfile.

  • New report “intervals”, available using arbtt-stats --intervals.

  • The paramters --exclude and --include of arbtt-stats can match categories as well as tags.

  • Bugfix: Numbers in tag names are no longer replaced by an underscore.

  • New paramters --output-exclude and --output-include of arbtt-stats.

Version 0.5 (The ZuriHac-Release)

  • New command arbtt-import, which imports the output from arbtt-dump.

  • The command arbtt-stats now supports the --logfile and --categorizefile as well. (Martin Kiefel)

  • The command arbtt-stats now supports the csv (comma-separated values) and tsv (TAB-separated values) report output formats in addition to text. (Muharem Hrnjadovic)

  • Unicode is handled correctly in regular expressions.

  • Improved date-handling functions for categorize.cfg. (Sergey Astanin)


  • Bugfix: Added missing modules to the cabal file.

Version 0.4.5

  • Implement a custom compression method greatly reduce the file size of the log file. Run arbtt-capture to compress the previous samples as well.

Version 0.4.4

  • Bugfix: Correctly parse a tag name containing a colon when passed to arbtt-stats --exclude.

  • Bugfix: Only warn once when the _NET_CLIENT_LIST X property is not set for the root window.

Version 0.4.3

  • Use fetchName from xmonad instead of xFetchName, as it works with unicode characters in window titles.

Version 0.4.2

  • Implement option --logfile to arbtt-dump.

  • New command arbtt-recover to rescue data from a proken data log file.

  • Actually include this documentation in the released tarball.

Version 0.4.1

  • Write this documentation

  • Drop dependency on setlocale: Copy the SetLocale module.

  • Drop dependency on tabular: Implement custom table rendering code.

  • In the absence of _NET_CLIENT_LIST, look for application windows as children of the root windows. This should work for users of window managers like i3 without EWHM support.

Version 0.4

  • Implement option --each-categories to arbtt-stats

  • Eliminate one possible cause for crashes of arbtt-capture.

Version 0.3.0

  • Switch to binary log file format, for greatly increased speed

  • arbtt-capture will automatically detect and convert log files in the old format.

Version 0.2.0

  • Add option --filter to arbtt-stats

  • Add option --sample-rate to arbtt-capture

  • Introduce time-base variables $time and $sampleage

Version 0.1.5

  • Use setlocale to get umlauts in window titles correctly

Version 0.1.4

  • Be smarter when figuring out what window is active. Thanks to CJ van den Berg for investigating the issue.

Version 0.1.3

  • Read _NET_CLIENT_LIST for the list of applications, for compatibility with window managers such as metacity

Version 0.1.2

  • Off-By-Ten error in the time display

  • Correctly show total number of records in --information

Version 0.1.1

Rename files to allow building on MacOS.

Version 0.1

Initial release of arbtt