Metadata-Version: 2.4
Name: terrahour
Version: 1.0.8
Summary: World clock for the terminal with a day and night map and a 24-hour timeline
Author: Alessio Coci
License-Expression: MIT
Project-URL: Homepage, https://github.com/ACoci86/terrahour
Project-URL: Issues, https://github.com/ACoci86/terrahour/issues
Keywords: world clock,time zones,tui,terminal,timezone,world map,tmux
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pillow; extra == "dev"
Dynamic: license-file

<p align="center">
  <img src="https://raw.githubusercontent.com/ACoci86/terrahour/main/docs/logo.svg" alt="terrahour" width="400">
</p>

<p align="center">
  <img src="https://github.com/ACoci86/terrahour/actions/workflows/tests.yml/badge.svg" alt="tests">
  <img src="https://img.shields.io/pypi/v/terrahour?label=pypi" alt="PyPI">
  <img src="https://img.shields.io/badge/license-MIT-green" alt="license">
</p>

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.

![terrahour main view](https://raw.githubusercontent.com/ACoci86/terrahour/main/docs/main.png)

## Install

```sh
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](https://github.com/ACoci86/terrahour/releases)
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

![demo](https://raw.githubusercontent.com/ACoci86/terrahour/main/docs/demo.gif)

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

| ![DST radar](https://raw.githubusercontent.com/ACoci86/terrahour/main/docs/radar.png) | ![markets view](https://raw.githubusercontent.com/ACoci86/terrahour/main/docs/markets.png) |
| --- | --- |
| **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. |

| ![ambient view](https://raw.githubusercontent.com/ACoci86/terrahour/main/docs/ambient.png) | ![compact view](https://raw.githubusercontent.com/ACoci86/terrahour/main/docs/compact.png) |
| --- | --- |
| **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.

## More

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](https://github.com/ACoci86/terrahour/blob/main/MANUAL.md).

Want to change the code? See
[DEVELOPMENT.md](https://github.com/ACoci86/terrahour/blob/main/DEVELOPMENT.md).

## Credits

* City list derived from [GeoNames](https://www.geonames.org/) (CC BY 4.0).
* Land mask rasterised from [Natural Earth](https://www.naturalearthdata.com/) (public domain).
* Geocoding and weather from [Open-Meteo](https://open-meteo.com/) (CC BY 4.0).
* Time zone rules come from your operating system's tz database through Python's `zoneinfo`.
* Several hardening fixes by [yourpwnguy](https://github.com/yourpwnguy).

## License

MIT. See [LICENSE](https://github.com/ACoci86/terrahour/blob/main/LICENSE).
