Convert between vcards and Haiku person files.
Iri al dosiero
Jaidyn Ann d79338589d Update e-mail addresses 2024-01-29 00:42:25 -06:00
ex Init 2020-05-03 16:11:00 -05:00
patches Init 2020-05-03 16:11:00 -05:00
README.txt Update e-mail addresses 2024-01-29 00:42:25 -06:00
person2vcard Update e-mail addresses 2024-01-29 00:42:25 -06:00
vcard2person Update e-mail addresses 2024-01-29 00:42:25 -06:00

VCARD2PERSON (and PERSON2VCARD)
===============================================================================
Some bash scripts that can convert in-between vcard and Haiku person files.
Sorta in the spirit of mbox2mail and mail2mbox.

It supports vcards of version 2.1, 3.0, and 4.0.— and supports all attributes
applicable to a person file (including photo [through URL or embeded image],
address, name, phone numbers, email, etc).

My use-case is converting contacts between my Android phone and Haiku, which
uses version 2.1 vcards, so that version's been tested fairly well. 
3.0 and 4.0 have only been tested on the example files in ./ex/


--------------------
USAGE
--------------------
usage: vcard2person vcard [-h] [-d directory] [-o path] file

People files will be created using the data from a vcard. Each vcard defined
by a given vcf/vcard file have its person file be named after the vcard's
full-name.
-o	changes the output person filename
-d	outputs all people files to a given directory-- useful if a file
	defines multiple vcards.
-h	prints this message.


usage: person2vcard [-h] [-v version] [-o path] person

Creates a vcard from the given person file's attributes. By default will
output to a file of the same name with a .vcf file-extension.
-o	changes output vcard filename
-v	specify vcard version: 2.1, 3.0, or 4.0. Defaults to 4.0.
	a random URL, and use it as the vcard's photo URL.
-h	print this message.


--------------------
CUSTOMIZATION
--------------------
It should be pretty easy to work with your own custom attributes-- a couple
examples are in './patches/', for a META:birthday attribute (BDAY) and for
a META:group (X-ANDROID-CUSTOM:vnd.android.cursor.item).


--------------------
BORING STUFF
--------------------
Author:  Jaidyn Ann <jadedctrl@posteo.at>
License: CC0