clocktable-by-tag

Group clocktable entries by their first tag.

#+BEGIN: clocktable-by-tag :files-fn cashpw/agenda-with-archives :block "2023-11-13" :maxlevel 5
|         |                                           |      <r> |      |
| Tag     | Headline                                  | Time (h) |      |
|---------+-------------------------------------------+----------+------|
|         | All *Total time*                          |   *4:13* |      |
|---------+-------------------------------------------+----------+------|
| finance | *Tag time*                                |   *0:07* |      |
|         | Confirm mortgage payment went through     |          | 0:03 |
|         | Confirm credit card payments went through |          | 0:04 |
|---------+-------------------------------------------+----------+------|
| health  | *Tag time*                                |   *1:42* |      |
|         | Stretch 1                                 |          | 0:16 |
|         | Stretch 2                                 |          | 0:14 |
|         | Brush teeth (morning)                     |          | 0:03 |
|         | Shoulders                                 |          | 1:09 |
|---------+-------------------------------------------+----------+------|
| study   | *Tag time*                                |   *0:23* |      |
|         | Flashcards                                |          | 0:23 |
|---------+-------------------------------------------+----------+------|
| nil     | *Tag time*                                |   *0:48* |      |
|         | Personal email                            |          | 0:01 |
|         | Walk (evening)                            |          | 0:47 |
#+END:

Thanks to ffevotte for setting the foundation.

Also check out =clocktable-by-category=.

Install

Doom Emacs

#+begin_src emacs-lisp :tangle packages.el
(package! clocktable-by-tag
  :recipe (:host github
           :repo "cashpw/clocktable-by-tag"))
#+end_src

#+begin_src emacs-lisp :tangle config.el
(use-package! clocktable-by-tag
  :after org)
#+end_src

Vanilla Emacs

TODO

Properties

:files

A literal list, or variable, of files to read.

:files-fn

A function which returns a list of files to read.

:merge-duplicate-headlines

Merge duplicate headlines when non-nil.

#+BEGIN: clocktable-by-tag :block "2023-11-27" ...
#+CAPTION: Clock summary at [2023-11-27 Mon 19:45], for Monday, November 27, 2023.
|      |                  |    <r> |      |
| Tag  | Headline         |   Time |      |
|------+------------------+--------+------|
|      | All *Total time* | *1:00* |      |
|------+------------------+--------+------|
| home | *Tag time*       | *1:00* |      |
|      | Laundry          |        | 0:20 |
|      | Laundry          |        | 0:20 |
|      | Laundry          |        | 0:20 |
#+END:

#+BEGIN: clocktable-by-tag :block "2023-11-27" :merge-duplicate-headlines t ...
#+CAPTION: Clock summary at [2023-11-27 Mon 19:45], for Monday, November 27, 2023.
|      |                  |    <r> |      |
| Tag  | Headline         |   Time |      |
|------+------------------+--------+------|
|      | All *Total time* | *1:00* |      |
|------+------------------+--------+------|
| home | *Tag time*       | *1:00* |      |
|      | Laundry          |        | 1:00 |
#+END: