Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

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


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)
 '(org-contacts-files "~/share/all/org-mode/")
 '(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.


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

The file 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/ 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 for missing contacts and contact images which is still valid for 2020-11-15 and Android 11 on a Google Pixel 4a phome.


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


Converting Emacs Org-mode org-contacts contact information to VCard format suitable for importing to Android 4.4





No releases published


No packages published
You can’t perform that action at this time.