diff options
Diffstat (limited to 'timer.1')
| -rw-r--r-- | timer.1 | 34 |
1 files changed, 31 insertions, 3 deletions
@@ -256,6 +256,9 @@ or when a stopwatch is stopped. .PP A hook is any executable file at that name; there is nothing to enable. A file that is missing or not marked executable is skipped silently. +The three are independent: installing only +.BR on_quit , +for instance, is a complete and normal setup. .SS Arguments Each hook is run with exactly three positional arguments. .TP @@ -316,9 +319,34 @@ line like any other. Three commented, working examples ship with the source and are installed to .IR PREFIX/share/doc/ttym/hooks/ . -They set the terminal title, send a desktop notification and play a -sound on completion, and record abandoned sessions to a TSV file. Copy -the ones you want and edit: +They form one coherent set but each works alone. Together they do two +things the binary cannot: +.IP \(bu 2 +Record intent against outcome. The session log behind +.B timer \-r +stores elapsed seconds only, so a finished 25m and an abandoned 30m that +ran 25m look identical in it. The duration you asked for is visible to +.B on_start +and nowhere else, so the examples write a START/DONE/QUIT record to +.I $XDG_STATE_HOME/ttym/sessions.tsv +that shows follow\-through. +.IP \(bu 2 +Focus mode. During a countdown they pause +.BR dunst (1) +notifications and any +.BR playerctl (1) +or +.BR mpc (1) +playback, and restore both when it ends. Every external command is +guarded, so the examples are harmless on a machine without them. +.PP +A commented +.BR timew (1) +bridge is included but off by default; it turns +.B \-c +comments into timewarrior tags. +.PP +Copy the ones you want and edit: .PP .RS .nf |