clock-tui - GitLite

KO | EN

gitlite — search

#ai #typescript #llm #machine-learning #deep-learning #nodejs #windows #awesome #cli #vue #pytorch #security #mcp #openai

clock-tui

(★ 240)

A clock app in terminal written in Rust, supports local clock, timer and stopwatch.

파일 탐색기

최종 버전 다운로드 (.zip)

- config.toml
- - rust.yml
- demo-clock-mode.gif
- demo-countdown-mode.gif
- demo-stopwatch-mode.gif
- demo-timer-mode.gif
- - config.toml
- - app.rs
  - clock_text.rs
  - config.rs
  - lib.rs
- .gitignore
- Cargo.toml
- README.md
- - main.rs
- Cargo.toml
.gitignore
Cargo.lock
Cargo.toml
LICENSE
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/race604/clock-tui

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd clock-tui

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Rust

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Rust (rustup) rustup으로 설치하면 cargo도 함께 설치됩니다.

$ cargo install clock-tui

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ cargo build가 에러 없이 끝나면 성공입니다. target/ 폴더에 실행 파일이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# clock-tui (tclock)

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

## Clock

![clock](https://raw.githubusercontent.com/race604/clock-tui/master/assets/demo-clock-mode.gif)

## Timer

![timer](https://raw.githubusercontent.com/race604/clock-tui/master/assets/demo-timer-mode.gif)

## Stopwatch

![stopwatch](https://raw.githubusercontent.com/race604/clock-tui/master/assets/demo-stopwatch-mode.gif)

## Countdown

![countdown](https://raw.githubusercontent.com/race604/clock-tui/master/assets/demo-countdown-mode.gif)

# Usage

## Install

Install executable by `cargo`:

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

## Basic usage

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

You can always use `-h` or `--help` to show help message, for exmaple

```shell
$ tclock --help

# or
$ tclock clock -h
```

## Clock mode, this it the default mode

```shell
$ tclock clock

# Or just run
$ tclock
```

For more details, run `tclock clock -h` to show usage.

## 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.

The timer mode also accept additional command to run when the timer ends, for example:

```
tclock timer -d 25m -e terminal-notifier -title tclock -message "'Time is up!'"
```

Here we use [terminal-notifier](https://github.com/julienXX/terminal-notifier) to fire a notification when time is up.

For more details, run `tclock timer -h` to show usage.

## Run stopwatch

```shell
$ tclock stopwatch
```

For more details, run `tclock stopwatch -h` to show usage.

## Run countdown

```shell
$ tclock countdown --time 2023-01-01 --title 'New Year 2023'`
```

You can use `-t` or `--time` to specify time, for example: `2023-01-01`, `20:00`, `'2022-12-25 20:00:00'` or `2022-12-25T20:00:00-04:00`.

You can use `-r` or `--reverse` to run in count-up mode, it counts up duration since the specific time.

For more details, run `tclock countdown -h` to show usage.

## 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, any one of: 
# Black, Red, Green, Yellow, Blue, Magenta, Cyan, Gray, DarkGray, LightRed,
# LightGreen, LightYellow, LightBlue, LightMagenta, LightCyan, White
$ tclock -c yellow

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

# License

MIT License, refer to [LICENSE](./LICENSE) for detail.