# tz

> Interactive TUI tool for displaying and comparing times across multiple time zones simultaneously

Stars: 903 · Language: Go · License: GPL-3.0 · Categories: Productivity

- Repository: https://github.com/oz/tz
- Page: https://www.trmn.sh/tools/tz

## Install

- Homebrew: `brew install tz`
- Go: `go install github.com/oz/tz@latest`

## Overview

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.

### Installation

```bash
# via Homebrew
brew install tz
```

```bash
# via Go
go install github.com/oz/tz@latest
```

## Alternatives

- [omm](https://www.trmn.sh/tools/omm.md): Keyboard-driven task manager for the command line with priority reordering and context management (Go, 334 stars)
- [circumflex](https://www.trmn.sh/tools/circumflex.md): Terminal-based Hacker News browser with vim-style navigation and built-in article reader (Go, 2.1k stars)
- [Pop](https://www.trmn.sh/tools/pop.md): Send emails from the terminal via a TUI or CLI flags, using Resend or SMTP, with Markdown bodies, attachments, and AI agent skill support. (Go, 2.9k stars)
- [Ticker](https://www.trmn.sh/tools/ticker.md): Terminal stock, crypto, and derivatives price watcher with position tracking, cost basis lots, currency conversion, and grouped watchlists. (Go, 6.3k stars)
- [gopass](https://www.trmn.sh/tools/gopass.md): Command-line password manager compatible with pass, supporting GPG encryption, Git versioning, and team collaboration (Go, 7.3k stars)

---

Canonical: https://www.trmn.sh/tools/tz