Skip to content
See people with their timezones from the Shell
JavaScript CSS Shell
Branch: master
Clone or download

Timezone extension for GNOME Shell

Timezone is an extension for GNOME Shell aimed at helping remote teams by making it easier to see where and when their coworkers are. It's inspired on .



Easy way

Go to GNOME Extensions page and install it from there.

Other way:

$ mkdir -p ~/.local/share/gnome-shell/extensions
$ git clone ~/.local/share/gnome-shell/extensions/timezone@jwendell
$ gnome-extensions enable timezone@jwendell

You should see a clock icon next to the clock.


You need a people.json file. By default we look for this file at your home directory. You can use a different path if you want. Just go to the preferences dialog. You can even use a remote location for this file (e.g.: This way a whole team can share the people.json file.

The format of people.json file is the following:

    "name": "Dan",
    "avatar": "",
    "city": "NYC",
    "tz": "America/New_York"
    "name": "Niel",
    "gravatar": "",
    "city": "Cape Town",
    "tz": "Africa/Johannesburg"
    "github": "torvalds",
    "tz": "America/Los_Angeles"

The only mandatory field is tz. Timezone codes are found here.

Photos can be provided through 3 fields:

  • gravatar: Supply the email address registered at or
    • Niel in the example above
  • avatar: Supply directly the URL of the image
    • Dan in the example above
    • It can also be a path to a local filename, like file:///path/to/image.png or just /path/to/image.png
  • github: Supply a GitHub username.
    • torvalds in the example above

Instead of filling individual fields you can supply a GitHub username. Then we try to get user's avatar, name and city from there. Still, we need the tz field. GitHub doesn't provide one for us. See torvalds in the example above. (Hopefully this might change in the future).

Individual fields have preference over remote providers. For instance, if you fill the fields name and github, we will use the name you provided, not the github one (although we still use github to fetch other data, like avatar and city).

You can’t perform that action at this time.