Metadata-Version: 2.4
Name: worldclock-tty
Version: 0.1.1
Summary: A terminal-based world clock that displays multiple timezones in real-time.
License-Expression: MIT
Project-URL: Homepage, https://github.com/carlosplanchon/worldclock-tty
Project-URL: Repository, https://github.com/carlosplanchon/worldclock-tty
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: colored
Requires-Dist: pendulum
Requires-Dist: typer
Requires-Dist: vtclear
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Dynamic: license-file

# worldclock-tty

A terminal-based world clock that displays multiple timezones in real-time.

## Installation with uv
```bash
uv add worldclock-tty
```

## Installation with pip
```bash
pip install worldclock-tty
```

## Usage

Run the clock:

```
chronos
```

Press `Ctrl+C` to exit.

The display shows your local time at the top, followed by all configured timezones in two columns, updated every second.

## Managing timezones

Timezones are stored in `~/.config/chronos/config.json`. Use IANA timezone names (e.g. `America/Chicago`, `Europe/Paris`).

```
chronos add America/Chicago       # add a timezone
chronos remove America/Chicago    # remove a timezone
chronos list                      # show configured timezones
chronos reset                     # restore built-in defaults
```

### Default timezones

America/Buenos\_Aires, America/Caracas, America/La\_Paz, America/Lima, America/Los\_Angeles, America/Montevideo, America/New\_York, America/Sao\_Paulo, Asia/Bangkok, Asia/Dubai, Asia/Hong\_Kong, Asia/Istanbul, Asia/Tokyo, Asia/Vladivostok, Atlantic/Bermuda, Atlantic/Canary, Australia/Sydney, Europe/London, Europe/Madrid, Europe/Moscow, Europe/Rome, Pacific/Honolulu.

## Requirements

Python 3.10+

## License

MIT
