Skip to main content

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

Project description

worldclock-tty

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

worldclock-tty screenshot

Installation with uv

uv add worldclock-tty

Installation with pip

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

Managing timezones

Timezones are stored in ~/.config/chronos/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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

worldclock_tty-0.3.1.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

worldclock_tty-0.3.1-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file worldclock_tty-0.3.1.tar.gz.

File metadata

  • Download URL: worldclock_tty-0.3.1.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for worldclock_tty-0.3.1.tar.gz
Algorithm Hash digest
SHA256 0674b346ee769fa4b5d8c877c4587da1366662e9c32250710d2a14d421e412e0
MD5 84a8fcfdb099083f9eb006b44defc463
BLAKE2b-256 2c3ff73f8a787ea87c23743983de2cd022a5a7547ea122505a28a094c7d19301

See more details on using hashes here.

File details

Details for the file worldclock_tty-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: worldclock_tty-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for worldclock_tty-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 86bc751cef20b81477dc8a56947e271648a2cdcdd04fa4c8064584378dc96b56
MD5 7dd15a8fbe85222537ac350b4df391a1
BLAKE2b-256 2b3bf74b412820c2dd960deb4ea4ad4fad6c30a79daae97abd66e5dc63e62ccb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page