Metadata-Version: 1.0
Name: goobook
Version: 1.0
Summary: Search your google contacts from mutt.
Home-page: http://goobook.googlecode.com/
Author: Christer Sjöholm
Author-email: goobook@furuvik.net
License: GPLv3
Description: =============================================================
        GooBook -- Access your Google contacts from the command line.
        =============================================================
        
        .. contents:: **Table of Contents**
        
        -------------------------
        About
        -------------------------
        
        The purpose of GooBook is to make it possible to use your Google Contacts in
        a MUA such as Mutt. It's use mimics that of abook (somewhat).
        
        -------------------------
        Installation Instructions
        -------------------------
        
        GooBook is only released as a source distribution.
        
        It can be installed using easy_install or pip or manually with the source
        tarball.
        
        easy_install or pip
        ===================
        
        Run easy_install or pip::
        
        $ easy_install -U goobook
        $ pip install goobook
        
        Source installation
        ===================
        
        Download the source tarball, uncompress it, then run the install command::
        
        $ tar -xzvf goobook-*.tar.gz
        $ cd goobook-*
        $ python setup.py install
        
        Upgrading
        =========
        
        If you are upgrading from a pre 1.0 version you will have to remove the old cachefile and create
        a new configuration.
        
        -----------------------------
        Configure
        -----------------------------
        
        For most users it will be enough to add an entry to your .netrc::
        
        machine google.com
        login your@google.email
        password secret
        
        To get access too more settings you can create a .goobookrc in your home directory::
        
        [DEFAULT]
        #If not given here, email and password is taken from .netrc using host=google.com
        email: user@gmail.com
        password: top secret
        #The following are optional, defaults are shown
        max_results: 9999
        cache_filename: ~/.goobook_cache
        cache_expiry_hours: 24
        
        -----------------------------
        Usage
        -----------------------------
        
        To query your contacts::
        
        $ goobook query QUERY
        
        The add command reads a email from STDIN and adds the From address to your Google contacts::
        
        $ goobook add
        
        The cache is updated automatically according to the configuration but you can also force an update::
        
        $ goobook reload
        
        Mutt Setup
        ==========
        
        Set in your .muttrc file::
        
        set query_command="goobook query '%s'
        
        to query address book. (Normally bound to "Q" key.)
        
        To add email addresses (with "a" key normally bound to create-alias command)::
        
        macro index,pager a "<pipe-message>goobook add<return>" "add the sender address to Google contacts"
        
        If you want to add an email's sender to Contacts, press a while it's selected in the index or pager.
        
        -----------------------------
        Feedback and getting involved
        -----------------------------
        
        - Mailing list: http://groups.google.com/group/goobook
        - Issue tracker: http://code.google.com/p/goobook/issues/list
        - Code Repository: http://code.google.com/p/goobook/source/checkout
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Topic :: Communications :: Email :: Address Book
