summaryrefslogtreecommitdiffstats
path: root/minitimer.1
blob: e0aa79d596ce8171a74c899661c133560b8dcd01 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
.TH MINITIMER 1 minitimer\-VERSION
.SH NAME
.PP
minitimer \- A timer in your terminal
.SH SYNOPSIS
.PP
.B minitimer
.RB [ \-sv ]
.RI [ HH:MM:SS ]
.SH DESCRIPTION
.PP
minitimer is a very simple timer that lives in the terminal of your system. It
supports pausing and resuming the countdown. It also provides a named pipe 
which you can pass commands to to control a running instance of minitimer.
.SH OPTIONS
.TP
.B \-s
Switch to stopwatch mode (i.e. counting time up), from the time provided at the
command line (00:00:00 by default).
.TP
.B \-v
Show version information and exit.
.SH USAGE
.PP
minitimer is started by passing the initial time in HH:MM:SS format (e.g. 
01:10:10 for 1 hour, 10 mins., 10 secs.). During execution, pressing these keys
will perform an action:
.TP
.B p
Pause/resume.
.TP
.B l
Show/discard lap.
.TP
.B +
Increment the countdown by 10 secs. (amount configurable in config.h).
.TP
.B q
Quit minitimer.
.SS Named pipe
.PP
On startup a named pipe is set up which allows for communication with a 
minitimer process by writing any of the commands listed above to the named pipe 
file. By default, the named pipe is located at
.B /tmp/minitimer.$PID.
.SH CONFIGURATION
.PP
minitimer is configured by creating a custom config.h and recompiling the 
source code.
.SH BUGS
.PP
Report bugs to https://todo.sr.ht/~arivigo/minitimer