## Time-stamp: <2020-11-15 22:26:31 vk> ## -*- coding: utf-8 -*- ## This file is best viewed with GNU Emacs Org-mode: http://orgmode.org/

org-contacts2vcard

This is a Python script that converts org-contacts contact information of GNU Emacs with Org-mode to Android 4.4 contact VCard import format.

Update 2020-10-20: I am still using this code to export my Org-contacts to my Android mobile phone (running Android 9). The reason why I wrote “version 4.4” above maybe was related to changes to the Android VCard format with version 4.4. I can’t remember.

• target group: users of Org-mode org-contacts who want to get their contact information to Android including:
  • First name
  • Last name
  • email addresses
  • phone numbers
  • user images
    • Note: the way contact images are referred to is personalized for me (see below). Therefore, you have to adopt either the script to your needs or you adopt my image method to your Org-mode :-)

Customizations: org-contacts

My org-contacts-template is more elaborated than the one in org-contacts.el. For example, I am using three separated properties for addresses (CITY, POSTALCODE, STREET) instead of one. If you are using different properties for certain entries, you might want to customize in your set-up.

As an example, here are my customizations:

(require 'org-contacts)
(custom-set-variables
 '(org-contacts-files "~/share/all/org-mode/contacts.org")
 '(org-contacts-address-property "CITY")
 '(org-contacts-birthday-property "BORN")
 '(org-contacts-icon-property "PHOTOGRAPH")
 )

You can have a look on my current Emacs configuration on github.

Example

Please take a look at the example org-contact file testdata/testcontacts.org

The file example_invocation.sh gives you some impression on how to invoke this script.

Please note that with 2020-11-15 I switched the international number prefix (IDD) from 00 to + because sources like this tells me this is safer.

Contact Images

In testdata/testcontacts.org you will notice contact photographs are included like this:

:PHOTOGRAPH: [[photo:FirstnameLastname.jpeg]]

photo: is a custom link which is defined in my org-mode configuration file:

(setq org-link-abbrev-alist
      '(
[...]
        ("photo" . "file:~/people/all_photographs/%s")
[...]
        ))

As you can see, I linked it to files in the folder $HOME/people/all_photographs.

If you use a similar definition, you are able to use my script without changes.

NOTE the open issue #1 for missing contacts and contact images which is still valid for 2020-11-15 and Android 11 on a Google Pixel 4a phome.

Contribute!

I am looking for your ideas:

If you want to contribute to this cool project, please fork and contribute!

I am using Python PEP8 and some ideas from Test Driven Development (TDD).

Local Variables