generated from PlexSheep/rs-base
84 lines
1.1 KiB
Markdown
84 lines
1.1 KiB
Markdown
# clock-tui
|
|
|
|
A clock app in terminal. It support the following modes:
|
|
|
|
## Clock
|
|
|
|
|
|
|
|
## Timer
|
|
|
|
|
|
|
|
## Stopwatch
|
|
|
|
|
|
|
|
# Usage
|
|
|
|
## 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.
|