convert gmail contacts to BBDB file, easy to use, robust, no dependency
Switch branches/tags
Clone or download
Latest commit a84fa38 Apr 23, 2017
Permalink
Failed to load latest commit information.
README.org fixed family and give name order problem Nov 5, 2016
gmail2bbdb.el Use dst-file variable Apr 13, 2017

README.org

gmail2bbdb (v0.0.6)

http://melpa.org/packages/gmail2bbdb-badge.svg http://stable.melpa.org/packages/gmail2bbdb-badge.svg

gmail2bbdb will import name and email from Gmail contacts into BBDB file. So you can auto-complete email address in Emacs.

Please note the BBDB file only contains name and email address. I remove useless BBDB features to minimize the maintaining cost.

Why

  • Easy to use. Only one command.
  • Robust. It has NO dependency.
  • Long term support. I will maintain it in next 10 years.

Install

Download gmail2bbdb.el and place it somewhere (say ~/.emacs/lisp). Add below code into your .emacs:

(add-to-list 'load-path "~/.emacs.d/lisp/")
(autoload 'gmail2bbdb-import-file "gmail2bbdb" nil t nil)

Usage

  • Install latest BBDB from melpa
  • At Gmail contacts page, click “More -> Export -> vCard format -> Export”, the file “contacts.vcf” will be downloaded.
  • Run command “M-x gmail2bbdb-import-file” and select contacts.vcf. “$HOME/.bbdb” will be created.

You can specify a different path of output file,

(setq gmail2bbdb-bbdb-file "~/.emacs.d/.bbdb")

You can specify the email excluded patterns. Email address matching one of the patterns will be excluded.

(add-to-list 'gmail2bbdb-excluded-email-regex-list "noreply@mycompany.com")

Tips (OPTIONAL)

See my BBDB setup.

Bug Report

Check https://github.com/redguardtoo/gmail2bbdb

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.