Sign In

AddressBooker

... aims to be a swiss-army knife for contact management, but right now doesn't do very much.

Currently it can just take a submitted form POST w/ JSON contacts data and either export a vCard file (for OS X or whatever), and/or merge that submitted data into your Google Contacts (for use in GMail, Android, etc.). See the announcement blog post.

To submit data, do a POST to http://addressbooker.appspot.com/submit with the following parameters:

groupOptional group name to put contacts in. Not required.
handleSome self-assigned handle for the data you're submitted. Pick something long and random. Must match regexp \w+. This is used if the user isn't logged in and the submitted contacts need to be stashed away with a key for awhile, during the Google sign-in/OAuth/Authsub redirect dance.
jsonSomething like:
[
 {
   "name": "Brad Fitzpatrick",
   "numbers": [
      { "type": "Mobile", "number": "555-1212"},
      { "type": "Home", "number": "555-1313"},
   ],
 },
 {
   "name": "Brad Fitzpatrick",
   "numbers": [
      { "type": "Mobile", "number": "555-1212"},
      { "type": "Home", "number": "555-1313"},
   ],
 },
]

(sorry, email addresses not supported yet: just names and numbers.)

Note: Joseph Smarr brought to my attention that this should be using the Portable Contacts JSON format instead and I agree. It's a tiny change. I'll do that first free chance I get. Or patches welcome.

When merging with your Google Contacts, it'll try to smartly merge into existing contacts if possible (matching on name, phone number), only creating new contacts as a last resort.

The source code to this whole app is available at:

http://github.com/bradfitz/addressbooker/tree/master

Patches welcome!



AddressBooker is a little hack by Brad Fitzpatrick <brad@danga.com>. It comes with no warranty of any kind.