waybar-worldclock

A simple world clock for Waybar. Shows local time in the bar, world times in the tooltip on hover.

Install

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

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

Install on Omarchy

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

This copies worldclock to ~/.local/bin/, creates the default zones config, and restarts Waybar. Then replace clock with custom/worldclock in modules-center in your ~/.config/waybar/config.jsonc. Since ~/.local/bin is not in Omarchy's PATH, use the full path in the module config:

"custom/worldclock": {
  "exec": "/home/<user>/.local/bin/worldclock",
  "return-type": "json",
  "interval": 30
}

To uninstall:

./uninstall-omarchy

Configuration

Edit ~/.config/worldclock/zones:

Time format

Set 12-hour (default) or 24-hour format at the top of the file:

format=12

12-hour format shows AM/PM (e.g. 09:30 AM), 24-hour format shows 09:30.

Timezones

One timezone per line, tab-separated:

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

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 (or wherever you want it):

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

Module definition:

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

Then restart Waybar (e.g. killall waybar && waybar &).

Uninstall

./uninstall

Dependencies

None — just bash and date.

License

MIT