worldclock-tty is a terminal-based world clock that displays local time alongside multiple time zones in real time.
It is particularly useful for users working with people or systems spread across different regions, providing a compact view without requiring a graphical application. Time zones are configurable using standard IANA names, while display options cover sorting, time formats, UTC offsets, colours, themes, military time, and refresh intervals.
This is free and open source software.
Key Features
- Displays local time together with multiple international time zones.
- Updates displayed times automatically at a configurable interval.
- Uses IANA timezone names such as Europe/London, Asia/Tokyo, and America/New_York.
- Can sort configured time zones by their UTC offset.
- Optionally displays the numeric UTC offset beside each time.
- Supports both 12-hour and 24-hour clock formats.
- Offers NATO/military timezone letters including Zulu time.
- Can display military Date-Time Groups with the day, time, zone letter, month, and year.
- Falls back to numeric UTC offsets for zones without an official military designator.
- Includes default, mono, matrix, amber, and ocean colour themes.
- Lets you override individual colours for cities, offsets, times, labels, dates, and local time.
- Can save a preferred colour theme as the default.
- Provides commands to add, remove, list, and reset configured time zones.
- Stores configuration under the XDG configuration directory.
- Ships with a useful selection of default time zones spanning the Americas, Europe, Asia, Australia, and the Pacific.
- Aligns refreshes to the wall clock when using custom update intervals.
Website: github.com/carlosplanchon/worldclock-tty
Support:
Developer: Carlos A. Planchón
License: MIT License

worldclock-tty is written in Python. Learn Python with our recommended free books and free tutorials.
Related Software
| Terminal-Based Clocks | |
|---|---|
| sigye | Much more sophisticated than the typical tray |
| Peaclock | Customizable clock, timer, and stopwatch for the terminal |
| ClockTemp | Inspired by tty-clock that displays the time, date, temperature and more |
| tty-clock | Terminal digital clock |
| talking-clock | Highly configurable talking clock |
| shalarm | Bash script that functions like an alarm clock |
| mongoclock | Humongous clock for the terminal |
| clock-tui | Clock app in terminal which supports local clock, timer and stopwatch |
| TetroTime | Clock, timer, and stopwatch that renders time using falling tetromino shapes |
| stardial | Space-anime themed terminal clock |
| Clox | Geeky clock for terminal enthusiasts |
Read our verdict in the software roundup.
Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category.This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more. Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form. |


Please read our Comment Policy before commenting.