Skip to main content

Search your google contacts from mutt.

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

goobook-1.0.tar.gz (23.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page