ACoci86/terrahour

A world clock for the terminal, with a day and night map and a 24-hour timeline to find a time that works across time zones.

NewPythonMIT Last commit 1 day ago acoci86.github.io/terrahour

Open on GitHub

Last 24 hours: +17; stars
Last 7 days: +33; stars
Last 30 days: +205; stars
Total stars: 205; created 16 days ago
Forks: 8; 2 contributors

Star history

Last 12 weeks · weekly cumulative stars · created Oct 1, 2026, zero before · computed from public GitHub star events

Momentum: #36 in Terminal this week · +33 stars this week

Rank in its topics

Position among repos ranked in each topic (min. 20 stars gained)

Rank of ACoci86/terrahour in each topic for today, this week and this month
Topic	Today	This week	This month
Terminal	–	#36of 103	#25of 189
CLI tools	–	#51of 137	#34of 237
Python	–	#376of 785	#213of 1122

Health signals

Too new to assessChecked Oct 17, 2026

Too new to assess: the repository is less than 60 days old or has fewer than 10 commits. The signals below are shown for information only.

Commit activity: Commits every week since it was created (3 weeks) 54 commits on the default branch in 90 days
Maintainers: 2 active maintainers Top author: 80% of the last 54 commits
Issue responsiveness: Median first response: 5 hours 4 of 7 issues opened in 90 days are closed
Pull requests: 11 merged, 0 closed, 1 open Of 12 pull requests opened in 90 days
Releases: Last release: 1 day ago 9 releases in the last 12 months
Project hygiene: License, CI; no security policy
OpenSSF Scorecard: Not scanned Unknown, not counted against the project

Signals are computed automatically from public GitHub data. They are not an endorsement or a security audit. How health is computed

README

README.md

A world clock for the terminal. It shows a map of the world with day and night on it, and for every city you add, when the people there are at work.

By Alessio Coci. MIT licensed: copy it, change it, keep the notice.

Install

pipx install terrahour

Then type terrahour. If you don't have pipx, install it first with sudo apt install pipx (Debian, Ubuntu) or brew install pipx (macOS). No Python at all? Download the ready-made file for your system from the releases page instead.

It runs on Linux and macOS. On Windows use WSL.

The first five minutes

It starts with a few example cities. Then:

Press	To
`a`	add a city: type its name and press Enter
`d`	remove the selected city
`←` `→`	move through the day, 15 minutes at a time
`r`	come back to now
`?`	see every key
`q`	quit

Your cities and settings are saved automatically.

What else it can do

Find a meeting time. Each city has a bar showing its working hours. The row at the bottom shows when everybody is at their desk at the same time.


See clock changes coming. The DST radar lists the next clock change in every city, and warns you when the gap between you and them is about to shift by an hour.	Watch the stock exchanges. Swap the city list for the ten biggest exchanges, with their real trading hours.


Put it on a spare monitor. The ambient view is a big clock over the map. Give it a time of day and the map slowly turns, keeping the place where it is that time in the middle.	Fit it anywhere. In a small window it shows a compact list; for a status bar there is a one-line mode.

Also: reminders in another city's time, the weather next to each city, a light theme and twelve more, a 12-hour clock, and the mouse.

Every key, every command-line option, status bars and scripts, window sizes, other ways to install, and how to update: it's all in the manual.

Want to change the code? See DEVELOPMENT.md.

Credits

City list derived from GeoNames (CC BY 4.0).
Land mask rasterised from Natural Earth (public domain).
Geocoding and weather from Open-Meteo (CC BY 4.0).
Time zone rules come from your operating system's tz database through Python's zoneinfo.
Several hardening fixes by yourpwnguy.