goobook(1)

NAME
goobook - access your Google contacts from mutt or the command line

SYNOPSIS
goobook [options] COMMAND

DESCRIPTION
goobook can be used to access your Google contacts from the command line. It can also be easily integrated into MUAs such as mutt. It can be used from mutt the same way as abook.

OPTIONS

-h, --help
    show the help message and exit

-c FILE, --config FILE
    specify alternative configuration file

-v, --verbose
    be verbose about what is going on (stderr)

-V, --version
    print version and exit

-d, --debug
    output debug information to stderr

COMMAND

add read an email address from stdin and add the From: address to your Google contacts

config-template
    create a config template of ~/.goobookrc

dump_contacts
    dump all your contacts to XML (stdout)

dump_groups
    dump your contact groups to XML (stdout)

dquery QUERY_STRING
    search contacts for QUERY_STRING, nice vcard like output

query QUERY_STRING
    search contacts for QUERY_STRING, plain text output

reload
    reload contacts from Google and update cache

CONFIGURATION

Basic configuration can be done in ~/.netrc

 machine google.com
   login your_login@gmail.com
   password your_password

To have access to more advanced options, you can generate .goobookrc config file by doing:

goobook config-template > ~/.goobookrc

An example config can look like this:

 [DEFAULT]
  email: your_login@gmail.com
  password: your_password
  cache_filename: ~/.goobook_cache
  cache_expiry_hours: 24

If you do not give email and password, they will be read from .netrc. You can set password to prompt, in this case goobook will ask for your password on every request. Instead of giving password in plain text, you can use passwordeval option to set a command for extracting password from a secure location. You can use gpg for this:

gpg --batch -d ~/encrypted_password_file.gpg

SEE ALSO
Website: https://pypi.python.org/pypi/goobook/

AUTHOR
This manual page has been written by Dariusz Dwornikowski <dariusz.dwornikowski@cs.put.poznan.pl>