Skip to main content

File-based contact management

Project description

File-based contact management


Each contact corresponds to a single file inside of the bguo directory. Contact information should be edited in this directory and then exported to various output formats for use by other programs. They can also be roughly imported to this directory, but you will have to proofread the results; the importers are intended for one-time imports, not for regular synchronization with other programs.

For our purposes, a contact is a thing with a single name, a single email address, &c. People, mailing lists, and organizations can all be contacts. bguo has no special features for grouping contacts.



pip3 install bguo


bguo -h


tar xzf bguo.tar.gz
cd bguo/examples

Supported formats

bguo supports only the formats that I (Tom) have used.

  • MH ~/.aliases file
  • Mutt alias_file
  • Newsbeuter ~/.newsbeuter/urls
  • Plain postal addresses
  • phonebook export
  • Seltzer CRM member listing (/?q=members)

For most of these formats, only the import or the export is supported, not both. This is summarized in the table below.

Format Import Export
MH Yes Yes
Mutt Yes Yes
Seltzer Yes No Yes No
Newsbeuter No Yes
Post No Yes

For imports, command-line program expects that you are converting from only one format to bguo. There was a case where I wanted to merge two formats for existing contacts, one for email addresses (MH) and the other for phone numbers (VoIP.MS). To do this, write a custom merging program with the functions in bguo.parse; examples/ is an example.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
bguo-0.2.1.tar.gz (3.6 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page