worldclock-tty 0.5.0

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

worldclock-tty

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

This program is a heavy refactor of a timezone clock I made in 2016.

Installation

uv tool install worldclock-tty

Usage

Run the clock:

worldclock-tty

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.

Options

Flag	Default	Description
--sort / --no-sort	on	Sort timezones by UTC offset (lowest first).
--offset / --no-offset	on	Show the UTC offset (e.g. UTC-3) next to each time.
--12h / --24h	--24h	Use a 12-hour clock with AM/PM instead of 24-hour.

worldclock-tty --no-sort          # keep the order from config
worldclock-tty --no-offset        # hide UTC offset labels
worldclock-tty --12h              # 12-hour clock with AM/PM
worldclock-tty --no-sort --no-offset

Managing timezones

Timezones are stored in $XDG_CONFIG_HOME/worldclock-tty/config.json (defaults to ~/.config/worldclock-tty/config.json). Use IANA timezone names (e.g. America/Chicago, Europe/Paris).

worldclock-tty add America/Chicago       # add a timezone
worldclock-tty remove America/Chicago    # remove a timezone
worldclock-tty list                      # show configured timezones
worldclock-tty 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