Giter Club home page Giter Club logo

org-contacts2vcard's Introduction

## 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

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.