world-wall-clock 0.1.0

TUI world clock application

world-wall-clock

world-wall-clock is a TUI application that provides a multi-timezone graphical clock in a terminal environment.

Installing world-wall-clock

You can install world-wall-clock with the Python packaging tool pip. It is recommended to do so in a virtual environment.

From PyPI

python -m pip install world-wall-clock

From the top level of the source repo.

python -m pip install .

Running world-wall-clock

In an environment with world-wall-clock installed, start it from the command line with:

wwclock

or

python -m world_wall_clock

Usage

world-wall-clock is a graphical application. By default it shows a live view of one local clock (the system time) and clocks for several time zones scattered around the world. By navigating using arrow keys and selecting or deselecting items from the sidebar of available timezones using the Enter or Space key, you can customize the list of displayed clocks. This is silently stored in the application configuration directory for the next time you launch world-wall-clock.

Using the "Custom time" radio button, you can switch the application into custom time mode

Dependencies

world-wall-clock is a Python 3 application that relies on urwid as its terminal widget toolkit, xdg-base-dirs to determine where to keep the application configuration, and tzdata to provide backup timezone information if this is not already present on the system.

Development

world-wall-clock uses Poetry to manage builds and dependencies. The Python code is formatted using Black.