clock-tui 0.2.0

A clock app in terminal
Documentation 
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

# clock-tui (tclock)

A clock app in terminal. It support the following modes:

## Clock

![clock](/assets/demo-clock-mode.gif)

## Timer

![timer](/assets/demo-timer-mode.gif)

## Stopwatch

![stopwatch](/assets/demo-stopwatch-mode.gif)

# Usage

## Install

Install excutable by `cargo`:

```shell
$ cargo install clock-tui
```

## Basic usage

```shell
$ tclock
```
Run this command to start a clock, and press `q` to exit.

```shell
$ tclock --help
```

## Clock mode, this it the default mode

```shell
$ tclock clock

# Or just run
$ tclock
```

## Run timer

```shell
# Start timer for 5 minutes
$ tclock timer -d 5m
```

The option `-d` or `--duration` to set time, for example `100s`, `5m`, `1h`, etc.

You can press `Space` key to _pause_ and _resume_ the timer.

## Run stopwatch

```shell
$ tclock stopwatch
```

You can press `Space` key to _pause_ and _resume_ the stopwatch.

## Customize style

You can customize the styles.

* Size

You can use `-s` or `--size` option to custome clock size, for example:

```shell
$ tclock -s 2
```

* Color

You can use `-c` or `--color` to set clock forground color, for exmaple:

```shell
# color name
$ tclock -c yellow

# or hex color
$ tclock -c '#e63946'
```

# License

MIT License.