Dock Icons Emoticons Contact List Styles Message Styles Sound Sets AppleScripts Status Icons Service Icons Menu Bar Icons Plugins Miscellaneous All
Adium Time Zone Plugin

Adium Time Zone Plugin

Submitted By Patrick Gibson (pblair)


This plugin adds time zone functionality to Adium by letting you specify a time zone for each contact. You will then be able to see their local time in the their tooltip when you hover over them.

For more info and source code, visit my website.

To Install:
Double-click the plugin icon. Adium should tell you that the plugin has been installed. Restart Adium.

To Use:
Right-click (or control-click) on any contact or group in your contact list. Select "Edit Time Zone..." and choose their nearest city. Click "Set Time Zone" and then when you hover over their name, you will see their Local Time in the tooltip.

To Uninstall:
Navigate to ~/Library/Application Support/Adium 2.0/Plugins/ and drag AdiumTimeZone.AdiumPlugin out of the plugins folder, and to the Plugins (Disabled) folder or to the trash.


- Made it work with Adium 1.3
- If you were using the plugin with Adium 1.3 Beta, fixed the crash-on-quit issue.

- Fixed Athens time.

- Fixed a localization issue where 24 hour clocks would not display (among other formatting issues).
- Added the following cities by request:
San Antonio
Oklahoma City

Initial Release!
Please let me know of any bugs.



You can reply to individual comments by clicking the "Reply" link next to each.

# by enkuturi-akrias on 03/31/07 at 20:47:08

Very good idea! I love this plugin cuz' i have lots of friends from other countries, and now i can know what is the time here :D
i give to this 4 ducks because you have to add more countries to South America, like the capital of mexico, and, can you add the country name to the city name (Example: Santiago, Chile) to found fastest the time zone?

Good job :P

# by enkuturi-akrias on 03/31/07 at 20:49:24

Sorry, mexico isn't is in South america, it is in North America.... owned ^_^'

# by BlackandWhitePenguin on 04/27/07 at 15:08:23

And the capital is called Mexico City (we gotta give 'em credit for the creative name).

# by rocasa on 06/12/08 at 11:55:00

Mexico is in Centroamerica

# by on 07/01/08 at 22:40:12

Mexico is not in Central America; it's in North America.
Central America: Belize, Costa Rica, El Salvador, Guatemala, Honduras, Nicaragüa, Panamá

# by rocasa on 07/02/08 at 16:55:27

You are right, sorry

# by Seeq on 03/31/07 at 21:16:15

This is an awesome plug-in. Definitely one of the best. I just wish this could be implemented into the user profile window. In my eyes it makes more sense that way rather than it's own window.

# by AzrimEkim on 04/01/07 at 15:41:38

It's not something I care enough to use, but it sounds like it's very well done.

# by Plentyofpaper654 on 04/05/07 at 22:17:10

Nice. I like the idea a lot, even though I don't have any contacts that aren't in the eastern US time zone :P. An issue with it though is that it doesn't work for me a lot of the time. I get the noise MacOS makes when something fails when I try it... I got it to work properly once before though, and it will keep the local time, but not allow me to edit it for others.

# by Wengero on 04/08/07 at 03:39:30

Is adium the selected application? If it is not it just makes the fail noise when you try.

# by Plentyofpaper654 on 04/09/07 at 10:39:24

Ah. I didn't understand what you meant at first, but that does seem to be the problem. I'm in the habit of having my contact list at the screen edge, and have it set to display above other windows and hide on screen edges, so I rarely have it in front as I just move my mouse to the side to bring up the contact list. That was the problem though. Thanks.

# by Arena on 03/27/08 at 00:30:32

Ehhh .... no I still don't get what you mean by "is adium the selected application". I still get the failure sound when I click on a contact and select the 'edit time zone' .... WHAT am I doing wrong ?


# by Plentyofpaper654 on 03/27/08 at 01:06:56

If in the menu bar in the top left (just after the apple icon) you see the word "Adium" then Adium is the selected application. If it says something else (i.e. Safari, Mail, iTunes, etc.) then that is the "selected application."
The selected Application is the application with the frontmost window, and it dictates what is shown in the menu bar.

# by Arena on 03/27/08 at 01:13:58

Ok I thought that was it but even though I have it selected it still makes that sound - so I thought you were talking about something else !!!
I have tried uninstalling it (the time zone plugin) - then installing it again - have the newest version of adium and haven't had any problems with anything what so ever in the past so I'm lost :(

Thank You for answering my "silly" question though !!!!

# by drfloppy on 04/08/07 at 18:00:36

about time there was this kind of thing for those of us with many friends around the globe.

# by tasmanian_devil on 04/11/07 at 14:42:30

does it have italy?

# by pblair on 04/11/07 at 17:05:38


# by kateweb on 04/12/07 at 08:02:16

very nice but it needs to support GMT I know the GMT/USD zones for a lot of my contacts not the city's, it would be nice to be able to use the city or the GMT/USD view. oh and can you add Belfast?
like I said very good for a first go. :)

# by malesca on 04/18/07 at 15:49:33

Nice, but: it displays 12-hour time ("8:45 e.m." (P.M.)) even though my system is configured for 24-hour time time ("20:45"). Could this be fixed?

# by pblair on 04/18/07 at 19:21:17

Hi malesca, yeah, this problem has been noted. It's actually more to do with a but on Apple's end (The way NSDateFormatter handles inputs), and as of this moment I don't believe there's anything I can do about it.

As soon as Apple fixes it I'll be posting an update!

# by neobusa on 04/20/07 at 07:24:39

Great plugin. No bugs so far. could you please tell me how to see how long others have been online as seen in the example you posted above. For Example: Online since 6:51 AM and Online since 3 hours and 8 minutes


# by pblair on 04/20/07 at 09:49:49

Hi neobusa. That's a feature of the AIM protocol. Not much can be done except getting more friends on AIM. :)

# by pecos on 05/12/07 at 19:14:32

Wonderful and useful, but...

I'm in Italy (CEST) and have a friend in Athens. She's showing up with -1 h, while it's the opposite, she's at +1h, I'm quite sure ^^

Cheers anyway :)

# by Wizardling on 07/19/07 at 23:15:43

Very handy! Leaves me wondering why Adium doesn't have this truly excellent feature built in. Thank you very much! :-)

# by Wizardling on 07/21/07 at 09:46:32

Could you please add:

Bridgeman Downs, QLD, Australia


Eau Claire, WI, U.S.A.

Cheers :-)

# by Wizardling on 07/21/07 at 20:23:18


Chattanooga, Tennessee

Nashville, Tennessee

Raleigh, North Carolina

Many thanks!

# by Wizardling on 07/21/07 at 20:25:41

oh, and Baton Rouge, LA as well, please.

# by Wizardling on 07/21/07 at 20:34:05

Actually, this is getting slightly nuts. Couldn't we just have +/- GMT instead?

# by dreamcore on 08/01/09 at 05:20:05

Couldn't you be satisfied with choosing America/Chicago and America/New_York instead? ;)

# by Wizardling on 08/01/09 at 07:11:16

You assume I have a clue which US cities are in the same zone :-D

# by habnabit on 07/28/07 at 16:51:10

This is an awesome plugin, but I'd also prefer to have the +/- GMT to make it slightly more sane.

# by xaphanthefallen on 07/30/07 at 19:13:49

FYI, the San Jose Time Zone is incorrect. Unless it's a different San Jose than in California. Is there any way to edit multiple people at a time instead of just one?

# by pblair on 07/30/07 at 19:43:20

Oops. Fixed in next version. Also, you can set time zones for groups, but right now multiple selection is not supported. I'll look into it for the next release!

# by bassman92 on 08/28/07 at 01:15:35

it doesn't seem to work with my msn contacts

# by bassman92 on 08/28/07 at 01:23:33

i'm stupid didn't read the instructions, sorry

# by bassman92 on 08/28/07 at 01:30:12

please add somewhere near Russelville Arkansas

# by dreamcore on 08/01/09 at 05:24:07

It's just U.S. Central Time, so America/Chicago works.

# by kateweb on 10/06/07 at 01:24:44

could you just add the 24 GMT/UDT time zones thats what I go by and it is a lot easyer the this city by city stuff.

# by Batshua on 10/07/07 at 14:48:35

Would it be really difficult to have the plugin grab this information from the Address Book if it's there?

# by kaze on 11/12/07 at 09:38:28

um am i retarded? i can't figure out how to use thing. and i'm on a mac so what am i missing?

# by kaze on 11/12/07 at 09:40:13

wait i got it LOL

# by Fr33dan on 11/16/07 at 00:43:27

I would be cool if you could see a person's local time while your in a chat with them (in the title bar maybe?).

# by Batshua on 12/02/07 at 10:14:53

I don't know how feasible this is, but it'd be nice if I could type in a city, state, and country, or a zip code, or coordinates, or even just a time zone. The dropdown menus *do* work, but it's tedious when you have over 100 buddies.

# by Max-Cady on 03/13/08 at 16:27:41

Awsome plugin. Really handy not to bother those overseas friends

# by seawitchipa on 07/06/08 at 20:39:39

So useful! With so many of us having family members deployed as well as international friends, I'm elated!

# by stellartrish on 07/31/08 at 12:51:11

Thank God for this!

I just have a question though: the local time is shown but the day and how long the person has been online doesn't show at all. what should I do?

please and thank you!

# by Kai85 on 08/06/08 at 04:53:45

it's a pity that it doesn't work for me in the version 1.3b10... what might it be...
will refer to your homepage next.

# by xeones on 08/26/08 at 21:25:16

Current Version: 1.3
Last Updated: 08/25/08

Unable to Download
An error occurred: Only the submitter, mods and admins are allowed to download Xtras before they are approved.

# by pblair on 08/26/08 at 21:44:53

Fixed. Xtra was approved.

# by xeones on 08/26/08 at 21:47:42

thanks :)

# by RealUnimportant on 08/27/08 at 10:41:19

It's nice you've tried to support people's requests for additions, but seriously - 40 cities each for Europe and Africa, when they cover just 3 or 4 timezones? Also, Continent != Time Zone. Please add the international standard +/- GMT/UDT comparisons, it'll make life so much easier and reduce the size of the menus considerably!

# by dmz on 09/01/08 at 15:12:59

Actually, while "Continent != Time Zone", "Region/City == Time Zone". Unlike +/- GMT/UDT specifiers, using something like "America/Los_Angeles" or "America/Phoenix" includes all the daylight saving time rules in addition to the actual time zone offset.

However, what he's done by including lots and lots of cities is not a great thing, because it's created zones that don't _really_ exist in official time zone definitions (much like changing "America" to "North America"/"South America". Given that, including +/- GMT would probably make sense... but it'd be much better to just let time zones be chosen the same way that Apple's "Date and Time" preference pane does, by picking them on a map. I wonder if that control (from "Date and Time" is reusable in some way...

# by Schubi on 12/21/08 at 07:37:54

Isn't it possible to fetch the time zone information directly from the Mac OSX address-book? Please also think of daylight savings!

# by Robert on 01/13/09 at 08:58:58

This plugin uses zoneinfo, which thinks of daylight savings and more. See dmz's comment above.

Do Leopard Address Book cards have time zone fields?

Anyway, this plugin is no longer working for me in Adium 1.3.3b1, OS X 10.4.11.

# by dreamcore on 08/01/09 at 04:46:46

Sorry, apparently I was wrong. The plugin as it exists now (1.3) doesn't actually use OS X's time zone information (zoneinfo).

# by kateweb on 02/19/09 at 12:48:08

how hard it it to set this thing to use GMT or UDT time zones ?

# by BlueRevolution on 03/04/09 at 11:58:05

Couldn't you use BST (London) instead of GMT? Adding new time zones probably isn't hard, but why would you want them? Actually, it might be pretty hard to set to UDT, since that doesn't exist. I assume you're talking about UTC. Either way, I don't know anyone that lives in UTC. In time zones that correspond to UTC, yes, but nobody actually lives there. Don't get me wrong, I set all of my servers to UTC no matter where in the world they are, but only for convenience.

# by kateweb on 03/04/09 at 22:03:45

I meant using the GMT scheme for all of them go GMT + 1 , +2 +3 ect out to all 24 GMT based times zones UTC is pretty much the same I feel ( along with others) that this would be a lot easier then listing every city on the planet. of each city I would have rewritten this my self if I was a coder but I'm not as of now I find it useless due to it not working properly.

# by dreamcore on 08/01/09 at 04:39:10

Civil time is a more complicated than this, though. There are changing laws and summer time (DST) dates, changing zone boundaries. You have places like Indiana, Arizona, Iran, and Venezuela. You could manage the changing UTC offsets yourself, though I thought our computers where clever enough to handle this for us.

Because of the zoneinfo-like city selections, I thought that this plugin somehow used the zoneinfo database in Mac OS X, and took care of these matters. It appears, however, that the plugin actually displays times based on offsets that the author supplies for specific cities, and summer time is ignored.

This explains why the menus are filled with redundant selections like Seattle and Philadelphia, while today I can't find a valid zone selection for a friend in Samara, Russia. (The real zoneinfo database has Europe/Samara.) If you do find a valid selection for your contact, it will be wrong when you enter/leave DST and your contact doesn't, and vice versa. (Just like if you had entered UTC+1, UTC+2:30, etc. in the first place.)

# by donelson on 04/12/09 at 20:33:42

(1) Why not use a World Time map instead of the obnoxious double-popup menu?

For example:

(2) Isn't there some way to ask the other client to find out what time it thinks it's in? And report it automatically?

I have some friends who won't tell what city they are in...

# by tomest05 on 05/10/09 at 10:46:06


I am currently on GMT + 3, Baghdad Iraq time (as a deployed officer), and my family is in California which is GMT - 8. However it is basically showing California as an hour ahead, for example currently it's 10:41 AM Baghdad time, but the plug-in has displayed for San Jose, California Local Time 1:41AM, currently it's actually 12:41 AM there. Does the plug in not figure in Day Light Savings time? Anyway I can adjust this? Thanks, great program idea! Especially international business, work, and family!


# by dreamcore on 08/01/09 at 05:34:45

You're right, as of this version (1.3), the plugin doesn't seem to know anything about DST or summer time. It will be still be correct if you and your contact go on summer time at the same time: the offsets will cancel out.

Iraq abolished DST in 2008, so it's going to be wrong there much of the time.

# by PhilMac on 01/26/10 at 19:42:57

Using the zoneinfo database seems to be the only way to avoid this sort of problem — clearly, the developer can't update the plugin every time the law changes somewhere! There seem to be a number of ways to hook into the database, so maybe pblair will take that on one of these days!

# by knitd on 09/30/09 at 14:31:41

This Xtra ist really really great. But I have a suggestion: It would be an even better Plugin, if it showed the local time zone of the other person in the chat window next to the messages, not only in the tool tip in the contact list

# by walder on 02/15/11 at 19:49:11

Some accounts provide buddy time-zone (i.e. ICQ) why do not use it as default to show local time ?

# by dmz on 10/30/11 at 13:16:14

This Xtra no longer works as of Adium 1.5 beta - at least, not on 64-bit Intel. Any chance of a new, universal build?

# by ccsgraphic on 11/07/11 at 12:54:15

The source code for 1.1 is available on the website. I suck at Objective-C, but I'm going to take a look at it eventually, see if I can update it.

# by Wizardling on 11/01/11 at 01:49:07

Sadly broken now :-(

Post a New Comment

You must be logged in to post comments.

Install | Download
36.57kb (50786 downloads)

4.10 / 265 votes
Current Version: 1.3
Last Updated: 08/26/08
Patrick B. Gibson, Earth, and the Sun.