Plot charts from arbtt-stats to terminal
arbtt-chart
Overview
Textual chart for [arbtt][], the automatic, rule-based time tracker.
Similar to [arbtt-graph][], just in plain monospace text.
(The above screenshot is generated using my [liskin-arbtt-stats][] which provides a few handy commands and combines data from multiple X sessions and Strava.)
Raw arbtt-stats output for the same time period looks something like this:
[arbtt]: http://arbtt.nomeata.de/ [arbtt-graph]: https://github.com/rejuvyesh/arbtt-graph [liskin-arbtt-stats]: https://github.com/liskin/dotfiles/blob/home/bin/liskin-arbtt-stats
Getting started
- Install arbtt and make sure
arbtt-capture runs in your graphical login session.
- Configure arbtt rules in
~/.arbtt/categorize.cfg.
- Try
arbtt-stats --output-format=csv --each-category | arbtt-chartor
arbtt-stats --output-format=csv --category=Graph | arbtt-chart
[Configuring the arbtt categorizer]: http://arbtt.nomeata.de/doc/users_guide/configuration.html [Effective Use of Arbtt]: http://arbtt.nomeata.de/doc/users_guide/effective-use.html [sample categorize.cfg for arbtt-graph]: https://github.com/rejuvyesh/arbtt-graph/blob/master/categorize.cfg
Installation
Using [uv][]:
$ uv tool install arbtt-chartUsing [pipx][]:
$ pipx ensurepath
$ pipx install arbtt-chartFrom a git clone:
$ git clone https://github.com/liskin/arbtt-chart
$ uv tool install ./arbtt-chartOr, since the only dependency is [pandas][], you can just sudo apt install python3-pandas and run arbtt_chart.py directly. :-)
[uv]: https://docs.astral.sh/uv/ [pipx]: https://github.com/pypa/pipx [pandas]: https://pandas.pydata.org/
Usage
$ arbtt-chart --help usage: arbtt-chart [-h] [--no-stacked] [--subtags] [--totals-re RE] Plot charts from arbtt-stats to terminal. Expects arbtt-stats --output- format=csv --category=… or arbtt-stats --output-format=csv --each-category output on stdin. options: -h, --help show this help message and exit --no-stacked don't stack bar chart --subtags recognize subtags (separated by '-') and sort them together --totals-re RE totals row regexp, default: ^\(total time\)$
Examples
single category
$ arbtt-stats --filter='$date >= 2021-03-0220:00 && $date < 2021-03-0303:00' \
> --min-percentage=2 --category=Activity --output-format=csv \
> | arbtt-chart
Activity
════════
Proj-arbttⁱ 03:11:40 ███████████▓██████████▓██████████▓██▏········÷···
Chat 00:30:20 ···········÷··········÷··········÷··█████▊···÷···
(8 entries omitted) 00:15:40 ···········÷··········÷··········÷·······▕██▊÷···
Web-Social 00:08:20 ···········÷··········÷··········÷··········▐▓▏··
Web-otherⁱ 00:06:40 ···········÷··········÷··········÷···········÷█▍·
Web-HN 00:06:20 ···········÷··········÷··········÷···········÷·▐▊
(unmatched time) 00:01:20 ···········÷··········÷··········÷···········÷··▕
(total time) 04:20:20 ███████████▓██████████▓██████████▓███████████▓███single category, subtags
$ arbtt-stats --filter='$date >= 2021-03-0220:00 && $date < 2021-03-0303:00' \
> --min-percentage=2 --category=Activity --output-format=csv \
> | arbtt-chart --subtags
Activity
════════
Proj arbttⁱ 03:11:40 █████████▓█████████▓█████████▓█·······÷···
Chat 00:30:20 ·········÷·········÷·········÷▕████▊··÷···
Web Social 00:08:20 ·········÷·········÷·········÷·····▕█▏÷···
otherⁱ 00:06:40 ·········÷·········÷·········÷·······█▏···
HN 00:06:20 ·········÷·········÷·········÷········▓▏··
(8 entries omitted) 00:15:40 ·········÷·········÷·········÷········÷██▋
(unmatched time) 00:01:20 ·········÷·········÷·········÷········÷··▕
(total time) 04:20:20 █████████▓█████████▓█████████▓████████▓███multiple categories
$ arbtt-stats --filter='$date >= 2021-03-0220:00 && $date < 2021-03-0303:00' \
> --min-percentage=2 --each-category --output-format=csv \
> | arbtt-chart
Activity
════════
Proj-arbttⁱ 03:11:40 ███████████▓██████████▓██████████▓██▏········÷···
Chat 00:30:20 ···········÷··········÷··········÷··█████▊···÷···
(8 entries omitted) 00:15:40 ···········÷··········÷··········÷·······▕██▊÷···
Web-Social 00:08:20 ···········÷··········÷··········÷··········▐▓▏··
Web-otherⁱ 00:06:40 ···········÷··········÷··········÷···········÷█▍·
Web-HN 00:06:20 ···········÷··········÷··········÷···········÷·▐▊
(unmatched time) 00:01:20 ···········÷··········÷··········÷···········÷··▕
(total time) 04:20:20 ███████████▓██████████▓██████████▓███████████▓███
Desktop
═══════
4_arbtt 02:21:40 ███████████▓██████████▓███▊······÷···········÷···
6arbttweb 00:50:20 ···········÷··········÷···▐██████▓██·········÷···
1_irc 00:34:00 ···········÷··········÷··········÷··██████▌··÷···
2_web 00:34:00 ···········÷··········÷··········÷········▐██▓███
(1 entries omitted) 00:00:20 ···········÷··········÷··········÷···········÷··▕
(total time) 04:20:20 ███████████▓██████████▓██████████▓███████████▓███
Program
═══════
urxvt 02:38:00 ███████████▓██████████▓██████▊···÷···········÷···
google-chrome 01:21:40 ···········÷··········÷······▐███▓██████████▉÷···
appelementio 00:14:40 ···········÷··········÷··········÷···········▓█▉·
(3 entries omitted) 00:06:00 ···········÷··········÷··········÷···········÷·▕█
(total time) 04:20:20 ███████████▓██████████▓██████████▓███████████▓███custom inputs
$ arbtt-chart --totals-re='^\(' <
custom inputs, multiple tables at same scale
$ arbtt-chart <
Contributing
Code
We welcome bug fixes, (reasonable) new features, documentation improvements, and more. Submit these as GitHub pull requests. Use GitHub issues to report bugs and discuss non-trivial code improvements; alternatively, get in touch via IRC/Fediverse/email.
See CONTRIBUTING.md for more details about the code base (including running tests locally).
Note that this project was born out of a desire to solve a problem I was facing. While I'm excited to share it with the world, keep in mind that I'll be prioritizing features and bug fixes that align with my personal use cases. There may be times when I'm busy with other commitments and replies to contributions might be delayed, or even occasionally missed. Progress may come in bursts. Adjust your expectations accordingly.
