Back to Catalog
findyourexit GitHub avatar

zonetimeline-tui

Terminal tool for visually comparing time zones and finding meeting slots

Demo

Terminal preview
zonetimeline-tui
Zone Timeline TUI — a guided tour of the live timeline ribbons and the world map view, driven by the shared cursor and day/night terminator

Overview

Terminal tool for visually comparing time zones and finding meeting slots

A terminal tool for visually comparing time zones — built for distributed teams.

From the maintainer

Origin story

This tool was born out of a practical need: managing a distributed team of engineers spread across distinct time zones around the globe. Finding good mutual time slots for meetings and synchronous work shouldn't require mental arithmetic or a web app — it should be a quick terminal command away.

First workflow

A great way to get a feel for `ztl` is to launch the TUI (using the plain `ztl` command) and add some timezones (with the `a` control). Persisting the timezones is as simple as hitting the `s` key. At a later stage, if you want to check in on the time in other timezones of interest, simply punch in `ztl`, and your saved timezones will be displayed.

Design choice

`ztl` is designed to be incredibly intuitive, but also lightweight. It aims to provide a delightful interactive TUI UX, without the need for ongoing interactivity beyond setup – instead becoming a customized point of reference for timezone-related information.

Latest Release

v0.4.0
Released: Jul 29, 2026

Added

  • A full-screen world map view: press m to toggle between the timeline and the map, or launch straight into it with ztl --map. Every configured zone is plotted on a Unicode-braille Web-Mercator projection that reflows with the terminal, coloured by the same core / shoulder / off availability as the timeline and driven by the shared cursor instant. A shaded day/night hemisphere with a solar terminator tracks the cursor so you can see at a glance who is awake, the focused zone is highlighted () with its local time on a status line, and UTC / fixed-offset zones sit on the equator at their offset longitude with a distinct hollow marker. Coastlines are bundled from Natural Earth and per-zone coordinates from the IANA time zone database, so the build stays offline and dependency-free.
  • The map keeps a correct aspect ratio at any terminal size, tiling the world horizontally to fill surplus width (the projection wraps like a cylinder) and letterboxing surplus height.
  • A default_view option in the config's [general] section (alongside the --map flag) to choose whether the TUI opens on the timeline or the map; saving in the TUI (s) persists whichever view you are in.

Discussions

0 comments
Loading comments...
Alvin By Alvin