| Author: | Nathaniel Beaver |
|---|
This is a Python 2/3 script to turn a directory full of vCard files into a single CSV file. It can also be imported and used as a module.
Not all of the vCard fields are preserved; currently only these fields:
- Name
- Cell phone
- Work phone
- Home phone
- Note
(I used this to convert vCards from an old LG Rumor 2 cell phone, so I have not needed to extract additional fields.)
If you encounter an error like this (Python 2):
Traceback (most recent call last):
File "vcard2csv.py", line 2, in <module>
import vobject # to parse vCard (vcf) files
ImportError: No module named vobject
or this (Python 3):
Traceback (most recent call last):
File "vcard2csv.py", line 2, in <module>
import vobject
ModuleNotFoundError: No module named 'vobject'
then you need to install the python vobject library, which you can do with pip:
pip install --user vobject
It is also in the major package managers.
https://src.fedoraproject.org/rpms/python-vobject
https://launchpad.net/ubuntu/+source/python-vobject
https://tracker.debian.org/pkg/python-vobject
https://security.archlinux.org/package/python-vobject
https://software.opensuse.org/package/python-vobject
https://software.opensuse.org/package/python2-vobject
https://software.opensuse.org/package/python3-vobject
The vCard files must have the suffix .vcf.
Simply run the script in the directory containing the vCard files
and specify the output filename:
python vcard2csv.py . foo.csv
Or point the script at a directory containing the .vcf files:
python vcard2csv.py example-vcards foo.csv
For additional help and options, pass the -h flag:
python vcard2csv.py -h
The script is compatible with both Python 2 and Python 3.
Only a few of the vCard fields are preserved; this may be undesirable.
vCard version 4.0 has not been implemented, though it would probably be straightforward to do so.
See the to-do list for more.
This project is licensed under the terms of the MIT license.