brent/ttz
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ttz/README.md
Brent Schroeter 942336a77c update documentation
2026-06-08 05:54:47 +00:00

1.5 KiB
Raw Blame History

Team Time Zones

A simple CLI app for displaying rich 24 hour time information for multiple people or locations.

Screenshot of a terminal window running the Team Time Zones TUI. The main feature is a table displaying a list of locations across the top including "Oakland", "UTC", and "Pacific Standard Time", each heading up a column of 24 cells displaying relative times throughout the day in the corresponding time zone. Standard 9 to 5 working hours are highlighted in brighter text, and the row representing the current hour is rendered in red. An input hint at the bottom reads "Filter" with a slash and "Quit" with a Q.

Install

# Install Rust toolchain
mise install
# Build executable
cargo build --release
# Move to path (substitute any destination in your $PATH)
cp target/release/ttz /usr/local/bin

Run

With example config:

ttz -c ./ttz.example.kdl

Or create a ~/.config/ttz.kdl to be loaded automatically. Refer to ttz --help for more information.

Configuration

TTZ uses the KDL format, with the following schema repeated for each desired location:

location "<DISPLAY NAME>" tz="<IANA TIME ZONE NAME>"

For valid time zone names, refer to the chrono_tz docs, Wikipedia, or the IANA database.

Time zone names are case-sensitive.