About AdiumBook

AdiumBook is an application useful to keep updated the information of your Adium and Address Book contacts.

You have some friends on your Address Book, right? But all of them are already added to your Adium contact list? AdiumBook can help you to find out.

You have lots of friends on your Adium contact list, some with nice pictures. Wouldn't it be nice to add them to your Address Book with a single button click? AdiumBook can make it for you.

Which of your Address Book cards don't have any IM field filled? And which don't have a picture? And which do use Jabber? AdiumBook comes to the rescue once again!

First steps

If you're new to AdiumBook, follow these steps:

1. Run AdiumBook — Easy, uh?

2. Choose the Reports > Adium contacts not in Address Book menu item.
   AdiumBook will scan all your contacts and will try to find all your Adium contacts that still don't have a card on your Address Book.

3. Choose some contact on the Adium list (left side).
   Her/his name and IM login will appear on the details pane below. A picture will also appear if she/he defined one.
   Maybe you have this person on your Address Book, maybe you don't. The report searches only by the IM field in Address Book, ignoring names, nicknames and e-mail addresses. But there is a button that makes a more detailed search.

4. Press the Find button.
   If you already have this person on your Address Book, she/he will appear on the listings at the right side. Just click on the name and the details will appear below. Now check the IM fields on the Address Book side. If they don't match with the current Adium contact, you can use the Set IM button to fix it. It's important to set the IM field of all your contacts, so Adium can recognize this person.
   If the Address Book contact (right) doesn't have a picture, but the Adium contact (left) have, you can copy this picture pressing the Set Pic button. It will appear instantly on the right side.
   If you don't have this person on your Address Book, you can add she/he by pressing the Add button. Simple as that. The name, IM login and picture will be filled in the card. Now you can press the Card button to edit this new card in Address Book.

5. Repeat steps 3 and 4 for every contact and you'll end with a very complete and consistent Address Book data.

Run AdiumBook from time to time to keep your contacts updated!

News for this version

• Fixed compatibility issues, now works with Adium 1.3 and newer.

• Fixed the display of Adium pictures, which wasn't working for some contacts.

• The Reports menu is now filled with fresh new items:
  • Adium contacts with AIM/Mac
  • Adium contacts with ICQ
  • Adium contacts with MSN
  • Adium contacts with Yahoo!
  • Adium contacts with Jabber/GTalk
  • Adium contacts with other IM
  • Adium contacts with picture
  • Adium contacts without picture
  • Address Book contacts with picture

• Added automatic software update, provided by Sparkle. Now you'll never have to download and install AdiumBook by hand anymore, it's all automatic. You can find it in AdiumBook > Check for Updates... menu.

• Prettier About panel, showing donators names and a link to the AdiumBook sources.

• New menu item AdiumBook > i use this. Please tell to the world that AdiumBook is nice! :)

• Service icons (ICQ, AIM, MSN, etc) were updated to match the new Adium icons.

And some other minor changes, registered on the complete Version History.

Enjoyed the new features? Want to see more on the next release? So please support the AdiumBook project, clicking on the ♡ Donate menu item.

This release took me 29 work hours to be made. I hope you like it!

Tips & Tricks

• If you want to list all your contacts, just make an empty search: delete the search text or press the X button.

• The text search is case insensitive, so don't mind about capitalization.

• The search results are sorted by name. You can click on the table headings to change the sort column. A second click makes a reverse sort.

• You can drag the table headings inner border to resize the columns width. See picture.

• In Address Book view, to copy the selected IM login to the clipboard, right click it. Yes, right click the Pop-up button.

• Click the contact picture to reveal its file in Finder.

• Click the Address Book icon to bring the Address Book application to the front.

• Click the sleepy Adium duck to check if Adium is online.

• Click the awake Adium duck to... discover for yourself! :)

• Adium must be Online. If don't, the search results will be very poor and incomplete.

• When you launch this application, both Adium and Address Book are also launched (if they aren't already running). AdiumBook needs them.

• The cross reports search only by service (not name or nickname). This is desired, because you need to fill the correct IM field in Address Book for those contacts, so Adium will know about them.

• To fully integrate the applications, set up Adium to get the contact's information from Address Book (picture and name). Open Preferences > Advanced > Address Book and check the following:
  • Import my contacts' names from the Address Book
  • Use Address Book images as contacts' icons
  • Combine contacts listed on a single card (or Consolidate contacts listed in the card for older versions)

Buttons

Try to find in Address Book the selected Adium contact.

The information for the currently selected contact (IM login and full name) is searched on the Address Book cards. AdiumBook tries to find them on the following fields: full name, nickname, e-mail addresses and IM information (AIM, ICQ, MSN, Yahoo and Jabber). The found contacts will appear on the Address Book side (right).

Try to find in Adium the selected Address Book contact.

Similar to the previous button, this one make the opposite: it gathers all the information for the current Address Book contact (full name, nickname, e-mail addresses, AIM/ICQ/MSN/Yahoo/Jabber names) and tries to find it on the Adium contact list (full name and IM login). The found contacts will appear on the Adium side (left).

Note: Multiple entries for the same person can appear, but each for a different IM service, and possibly with a different picture.

Show the contact's card in Address Book.

This button brings the Address Book application to the front, showing the card of the selected contact. Then you can make quick updates on it. Useful after adding an Adium contact to Address Book (See next button).

Note: In Address Book, the "All" group must be selected and its search field must be empty.

Add the Adium contact to Address Book.

This button creates a new card in Address Book, using the information of the selected Adium contact: name, IM login and picture. Before adding a new card, you can search for the contact in Address Book using the "Find in Address Book" button.

Copy the contact's IM login from Adium to Address Book.

This button sets the IM field of the selected Address Book contact using the IM login (number, e-mail or username) of the selected Adium contact. Useful to consolidate the contacts, so Adium can use their card's information. You can find people with missing IM information in Address Book using the "Address Book contacts with no IM" report (see Reports).

Note: This button really sets the Address Book card IM field. It doesn't overwrite the previous contents (if any), but creates a new field. (In AdiumBook version 1.2 and older, it was an overwrite operation.)

Copy the contact's picture from Adium to Address Book.

This button sets the picture of the selected Address Book contact using the picture of the selected Adium contact. In simple words, copy the picture on the left to the right. You can find people with missing picture in Address Book using the "Address Book contacts with no picture" report (see Reports).

Note: This button really sets the contact's picture in Address Book. It overwrites the previous picture (if any) and this operation cannot be undone.

Reports

• Adium contacts with AIM/.Mac
• Adium contacts with ICQ
• Adium contacts with MSN
• Adium contacts with Yahoo!
• Adium contacts with Jabber/GTalk
  Lists all Adium contacts from the specific IM service. Which one your friends use most?
  Note: You must be online. If you're offline, the report will be empty for that service.

• Adium contacts with other IM
  Lists all Adium contacts from other IM services, such as Facebook, Gadu-Gadu, MobileMe, MySpace and more.
  Note: You must be online. If you're offline, the report will be empty for that service.

• Adium contacts with picture
• Adium contacts without picture
  Lists all Adium contacts who (don't) have picture set. It's another way for you to manage your contacts.

• Adium contacts not in Address Book
  Find your Adium-only contacts. With this report you can find people who you use to chat but don't have a card on your Address Book. Maybe you are forgetting somebody special? Or maybe you already have added some of them but just forgot to fill the IM field on Address Book.

• Address Book contacts with AIM/.Mac
• Address Book contacts with ICQ
• Address Book contacts with MSN
• Address Book contacts with Yahoo!
• Address Book contacts with Jabber
  Lists all Address Book contacts who have the specific IM field filled. Useful to find inconsistencies in the people's cards.

• Address Book contacts with no IM
  Lists all Address Book contacts who have no IM field filled. They are smart people who have a real life and don't spend time chatting on the computer. Or maybe you just forgot to fill their info ;)

• Address Book contacts with picture
• Address Book contacts without picture
  Lists all Address Book contacts who (don't) have picture set. What about to give the faceless people a face? Use the "Find in Adium" button to try to find them in Adium, so you can use their IM picture (icon, avatar, ...) on the Address Book card.

• Address Book contacts not in Adium
  Find your Address Book-only contacts. With this report you can find people who have one or more IM informed on the Address Book card, but you haven't them in your Adium contact list. You know the girl, maybe she's online, but you can't talk to her because she's not on your list. AdiumBook helps you to get social!

• Your statistics (Command-S)
  A nice report with your usage statistics. It shows how many searches, reports and actions you have made so far. Based on that numbers, it shows the estimated total time AdiumBook saved you from doing manual and boring tasks on both Adium and Address Book.
  

Contact

• Contact the author in verde@aurelio.net.

• Visit the AdiumBook website and leave a comment.

• Help to promote AdiumBook to new users! Sign the AdiumBook profile at i use this website.

• Found a problem? Check the troubleshooting section on the website. If your problem isn't there, or if you have a suggestion for future releases, please use the AdiumBook > Report an issue menu item.

• Enjoy!