Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 3.5.4 instead.

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

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 details)

Uploaded Source

File details

Details for the file goobook-1.0.tar.gz.

File metadata

  • Download URL: goobook-1.0.tar.gz
  • Upload date:
  • Size: 23.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for goobook-1.0.tar.gz
Algorithm Hash digest
SHA256 c16476b8147bb3ef766b500362cf4b0054368641c8b1ed1a5b3ac5dc480dbf68
MD5 6af5d2f9d9984aebe4f663b28b47b57c
BLAKE2b-256 2a9370c11f58be16dde155fccef525988cd189e9a2a700ce9c03bb5b07b6acb0

See more details on using hashes here.

Release history Release notifications | RSS feed

3.5.4

2 files

3.5.3

2 files

3.5.2

2 files

3.5.1

2 files

3.5

2 files

3.5rc1

2 files

3.4

2 files

3.3

2 files

3.2

2 files

3.1

2 files

3.0.2

2 files

3.0.1

2 files

3.0.0

2 files

3.0rc1

2 files

1.9

1 file

1.8

1 file

1.7

1 file

1.6

1 file

1.5

1 file

1.4

1 file

1.3

1 file

1.2

1 file

1.1

1 file

This release

1.0 This release

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page