DragonFly On-Line Manual Pages

goobook(1)                          goobook                         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>

                                April 12, 2014                      goobook(1)