Interactive TUI tool for displaying and comparing times across multiple time zones simultaneously
tz is an interactive terminal user interface (TUI) application for scheduling and time coordination across multiple time zones. The tool displays your local time alongside UTC and any additional time zones you specify from the standard tz database. This makes it particularly useful for distributed teams, remote workers, and anyone who frequently schedules meetings or coordinates activities across different geographical locations.
The program accepts time zones as command-line arguments, through the TZ_LIST environment variable (semicolon-separated), or via a TOML configuration file at ~/.config/tz/conf.toml. Time zones can be aliased with custom names, such as "EMEA office" or "US office" for better organization. The interface automatically adapts to both light and dark terminal themes.
Configuration options are applied in a specific hierarchy: configuration file settings are overridden by environment variables, which are then overridden by command-line arguments. The local time zone is always displayed first, with additional zones listed below. The tool is built in Go and supports debugging through a DEBUG=1 environment variable that writes logs to debug.log.
# via Homebrew
brew install tz
# via Go
go install github.com/oz/tz@latest