cozy-vcard is a simple library to deal with the vcard format. It makes life easier to parse vcard files.
# Import
var vcf = fs.readFileSync('test/friend.vcf', 'utf8');
var vparser = new VCardParser(vcf);
var vcontact = parser.components[0];
var vsomeprop = contact.properties[0]:
// vcontact.org == 'SuperCorp'
// someprop.value == '+33123456789'
// someprop.name == 'tel'
// someprop.type == 'home'
// someprop.pref == true
# Export
var vcfString = VCardParser.toVCF(vcontact);
var vcf = fs.writeFileSync('test/friend-export.vcf', vcfString, 'utf8');
This vCard importer doesn't try to follow the official RFC. It is just made to handle properly vCards from major vendors: Google, Android, iOS, OSX and thunderbird.
The vCard exporter follow the Google way to write vcards. It can take an option to export the data to Android format or iOS format
Data are stored as direct fields when vendors provide them that way. If not they are handled as "datapoints". One data datapoint has three fields:
name
: the category of the datatype
: the label of the fieldvalue
: the value of the field
If you want to contribute, here is a non-exhaustive list of things to do to make this project perfect!
Export:
- manage properly the
pref
attribute. - manage properly custom types (currently they are often exported uppercased).
Tests:
- Make full tests field values totally agnostic.
- Test all fields of full vCards during import and export.
Handle other vendors:
- Thunderbird plugins
- Outlook
- FullContact
Cozy is a platform that brings all your web services in the same private space. With it, your web apps and your devices can share data easily, providing you with a new experience. You can install Cozy on your own hardware where no one profiles you. You install only the applications you want. You can build your own one too.
You can reach the Cozy community via various support:
- IRC #cozycloud on irc.freenode.net
- Post on our Forum
- Post issues on the Github repos
- Via Twitter