Recommended Free Tools
iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more
worldclock-tty puts your local time and several configurable international clocks in one terminal display. It is a Python command-line tool for readers who want IANA time zones, adjustable refresh timing, military time or Date-Time Groups, and customizable color themes without opening a graphical clock app.
What worldclock-tty displays
The project describes itself as “A terminal-based world clock that displays multiple timezones in real-time.” Local time appears at the top, with configured zones arranged in two columns beneath it. The display updates once per second by default. The software is a substantial refactor of a timezone clock its author made in 2016. Official project README
It is a terminal interface, not a graphical clock. Its listed defaults span the Americas, Europe, Asia, Australia, and the Pacific; you can change the set to suit your own locations.
Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchWindows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallInstall and start the clock
worldclock-tty requires Python 3.10 or later. The project’s documented installation method uses uv:
#1 Best Overall
- Wood Case Clock
- Ebony Veneer Pattern With Mahogany Stain
- Brushed Stainless Steel Corners
uv tool install worldclock-tty
worldclock-tty
Use Ctrl+C to exit the running clock. The project README documents these commands; installation details and availability may vary with your Python environment. Official project README
Manage the time zones you see
Enter IANA time zone names, such as America/Chicago or Europe/Paris. The tool includes commands to add, list, remove, and reset configured zones:
Rank #2
- INDUSTRIAL THEME: Designed with rugged charm and edgy allure, where metal finishes and raw materials unite to create an urban aesthetic that showcases your artistic expression
- STAINLESS STEEL METAL : An artful combination of aluminum, stainless steel, plastic, and glass materials, resulting in a sleek desk clock that enhances the workspace
- GOLD AND DARK BLUE MATTE FINISH: A tabletop clock that features a matte gold outer frame and a black clockface, adding a touch of elegance to its industrial design
- WORLD MAP ROUND CLOCK: A round tabletop clock that encapsulates the world map design on the small dome, complemented by a contrasting black clockface
- SMALL SIZE: The gold stainless steel metal clock measures 5.6L x 4W x 6.4H inches, and weighs 1.12 lbs
worldclock-tty add America/Chicago
The configured zone list is stored in $XDG_CONFIG_HOME/worldclock-tty/config.json. If XDG_CONFIG_HOME is not set, the default path is ~/.config/worldclock-tty/config.json. This lets the clock retain its timezone setup between runs.
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Choose the time format and refresh behavior
Display options let you select 12- or 24-hour time, show or hide numeric UTC offsets, sort zones by offset, and change the refresh interval. The interval aligns to the wall clock, according to the README. These examples show documented switches:
Rank #3
- Black wood frame with decorative silver map details
- Six-city world time wall clock
- Includes 32 pre-printed silver city name plaques
- Powered by 6 AA battery (included)
- Overall dimensions: 23.5 X 33.5 X 2.25
worldclock-tty --12hselects 12-hour time.worldclock-tty --no-offsethides numeric UTC offsets.worldclock-tty --no-sortdisables sorting by offset.worldclock-tty -n 5sets the refresh interval to five seconds.
Numeric offsets can help distinguish zones that share an abbreviation or whose local time differs by a fraction of an hour. Verify flags against the project README if using a different release.
Use military time or a Date-Time Group
For military-style notation, the README documents --military and its alias --zulu. The --full-military and --dtg options show a Date-Time Group at minute precision. Zones without an official NATO/military zone letter use numeric fallbacks, as described by the project.
Rank #4
- The Golden Globe Desk and Tabletop Clock by Seiko has been designed with a birds-eye globe view and world time bezel featuring twenty-four time zones
- Created with a solid brass case and a quiet sweep second hand which moves continuously, eliminating annoying ticking sounds and allowing worry-free use in quiet spaces
- Measures approximately 6.18 x 3.7 x 3.62 inches; Requires 1 x AA battery (included); Impressive clock is wonderful way to add sophistication to any room
- Created with quartz movement making it the most accurate at time keeping
- Contained in protective packaging; Ready to be easily gifted for Christmas, a birthday, housewarming, or to make any moment special
worldclock-tty --military
worldclock-tty --full-military
You can combine military notation with a UTC clock using worldclock-tty --military --utc.
Free tools Windows power users keep installed
One-click scans. No signup required.
Set a color theme
Built-in themes are default, mono, matrix, amber, and ocean. Select one for a run with --theme, or override an individual display element’s color:
Best Value
- 【Retro & Stylish Design】 Crafted from high-quality metal, this Azxb alarm clock is built to last. Its golden steel ring and round clock face create a stunning vintage look from every angle. The simple yet elegant color scheme adds a touch of sophistication to any home decor, making it a perfect gift or a charming addition to your space
- 【Clear & Easy-to-Read Display】Featuring HD glass and a crisp digital display, this alarm clock ensures you can easily read the time at a glance. The gold bronzing technology and bold Arabic numerals enhance visibility, while the Art Deco-inspired design adds a classic touch to your furniture
- 【Silent Operation】 Say goodbye to annoying ticking sounds! This analog alarm clock is equipped with a precise quartz silent movement, ensuring super-quiet operation that won't disturb your sleep. Enjoy peace and quiet throughout the night
- 【Backlight/Night Light Function】Need to check the time in the middle of the night? Simply press the white button on the back, and the screen will illuminate with a soft night light. This feature makes it easy to read the time without disturbing your sleep, as the night light won't turn on unless pressed. Tips:Press and hold the night light button for the light to stay on; release the button and it turns off.
- 【Easy to Setup & Portable Design】 The function keys, including night light, time display, alarm setting, and alarm switch, are conveniently located on the back of the clock for easy access. Both the elderly and children can set it up with ease. Plus, its compact size (3.7" x 4.1" x 2.6") makes it perfect for carrying around or placing on any surface, such as bedside tables, desks, or kitchen counters. Powered by 1 AA battery (not included), this alarm clock is a practical and stylish choice for everyone, from kids to adults
worldclock-tty --theme ocean
worldclock-tty --color time=green
The saved theme is the only persisted display preference documented by the project. Per-run color overrides are not saved as defaults; the README explains how to save a theme as the default. Official project README
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Release, license, and fit
PyPI lists worldclock-tty 0.4.4, uploaded February 28, 2026, and identifies Python 3.10 or later as a requirement. The package declares the MIT license. Those are registry details for that release, not a guarantee that a newer version will not appear. worldclock-tty on PyPI
It is a practical fit if you want several named time zones visible together in a terminal and value controls for refresh cadence, military notation, offsets, and colors. The documented feature set does not establish platform-specific support beyond its Python requirement, so check your environment before relying on it.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

