If you use Waybar on your Linux desktop (for example with Omarchy), you might want to see the time in different timezones without opening a browser or running extra apps.

waybar-worldclock is a small utility that shows your local time in the bar and displays world times in the tooltip when you hover over it.

Installation

git clone https://github.com/alexzeitler/waybar-worldclock.git
cd waybar-worldclock
./install

This copies the worldclock script to ~/.local/bin/ and creates a default config at ~/.config/worldclock/zones if none exists.

Configuring timezones

Edit ~/.config/worldclock/zones with one timezone per line, tab-separated:

America/New_York    New York
Asia/Tokyo          Tokyo
Europe/London       London
Australia/Sydney    Sydney

You can find valid timezone names with timedatectl list-timezones.

Waybar setup

Replace the built-in clock module (or add alongside it) in your ~/.config/waybar/config.jsonc:

"modules-center": ["custom/worldclock"]

Then add the module definition:

"custom/worldclock": {
  "exec": "worldclock",
  "return-type": "json",
  "interval": 30
}

Restart Waybar (killall waybar && waybar &) and you are good to go.

Uninstall

./uninstall

The source code is on GitHub.