README for contacts
The utility contacts gives you access to view and search all your records in the AddressBook database.
To install contacts, double click the contacts1.1.pkg and follow the instructions. To uninstall contacts, run the following commands (if you're installing contacts, you should be somewhat comfortable with the command line):
$ rm /usr/bin/contacts
$ rm /usr/share/man/man1/contacts.1
With version 1.1, contacts is now installed in /usr/bin instead of /usr/local/bin; the '-S' option was added; firstname first or vice versa is now handled correctly; added the notes to the search fields; added tokens to access addresses (i.e. '%a', '%ha', etc); added '%u' token to access unique identifier for each person.
Without further ado, here are a few examples:
$ contacts -h
usage: contacts [-hHsmnlS] [-f format] [search]
-h displays help (this)
-H suppress header
-s sort list
-m show me
-n displays note below each record
-l loose formatting (doesn't truncate record values)
-S strict formatting (doesn't add space between columns)
-f accepts a format string (see man page)
displays contacts from the AddressBook database
$ contacts
NAME PHONE IM EMAIL
Kim Jong Il +82-(001)385 License2KimJongill mrill@axisofevil.org
George W Bush 202-276-4300 Bush43 big.dubya@whitehouse.gov
[...]
$ contacts bush
NAME PHONE IM EMAIL
George W Bush 202-276-4300 Bush43 big.dubya@whitehouse.gov
$ contacts -f "%n %w" mrill
NAME HOMEPAGE
Kim Jong Il http://www.livejournal.com/users/kim_jong_il__/
For more info and details, see the man page. :)
Contributions, patches, ideas, and criticisms are welcome.
-shane (at) gnufoo (dot) org