worldclock-tui 1.0.1

A small Rust terminal UI that shows the current time across UTC offsets or the full IANA timezone list.
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

# World Clock

> Disclaimer: this project is completely vibecoded.

A small Rust terminal UI that shows the current time across UTC offsets or the full IANA timezone list.

![Screenshot](img/screenshot.png)

![Demo](img/demo.gif)

## Features

- Live-updating clock display in a terminal UI
- Two views: compact UTC offsets and full timezone database
- Scrollable table with keyboard navigation
- Highlights the local timezone offset and marks yesterday/tomorrow differences

## Run

```bash
cargo run --release
```

## Install

```bash
cargo install worldclock-tui
worldclock
```

## Controls

- `q` or `Esc`: quit
- `a`: toggle between UTC offsets and all IANA zones
- `Up` / `k`: scroll up
- `Down` / `j`: scroll down
- `PageUp`: jump up one page
- `PageDown`: jump down one page
- `Ctrl-u`: jump up half a page
- `Ctrl-d`: jump down half a page
- `gg` or `Home`: jump to the top
- `G` or `End`: jump to the bottom

## Notes

- Built with `ratatui` and `crossterm`
- Timezone data comes from `chrono-tz`
- If the terminal window is too small, the app shows a resize warning instead of the table