khard¶

Synopsis¶

khard [-c CONFIG] [--debug] [--skip-unparsable] SUBCOMMAND …

khard -h | --help

khard -v | --version

Description¶

khard is an address book for the Unix command line. It can read, create, modify and delete carddav address book entries. khard only works with a local store of VCARD files. It is intended to be used in conjunction with other programs like an email client, text editor, vdir synchronizer or VOIP client.

Options¶

-c CONFIG, --config CONFIG¶: configuration file (default: ~/.config/khard/khard.conf)

--debug¶: output debugging information

-h, --help¶: show a help message and exit

--skip-unparsable¶: skip unparsable vcards when reading the address books

-v, --version¶: show program’s version number and exit

Subcommands¶

The functionality of khard is divided into several subcommands. All of these have their own help text which can be seen with khard SUBCOMMAND --help.

Listing subcommands¶

These subcommands list information of several contacts who match a search query.

list: list all (selected) contacts
birthdays: list birthdays (sorted by month and day)
email: list email addresses
phone: list phone numbers
postaddress: list postal addresses
filename: list filenames of all matching contacts

Detailed display¶

These subcommands display detailed information about one subcommand.

show: display detailed information about one contact, supported output formats are “pretty”, “yaml” and “vcard”
export: DEPRECATED, use show --format=yaml instead

Modifying subcommands¶

These subcommands are used to modify contacts.

edit: edit the data of a contact, supported formats for editing are “yaml” and “vcard”
new: create a new contact
add-email: Extract email address from the “From:” field of an email header and add to an existing contact or create a new one
merge: merge two contacts
copy: copy a contact to a different addressbook
move: move a contact to a different addressbook
remove: remove a contact
source: DEPRECATED, use edit --format=vcard instead

Other subcommands¶

addressbooks: list all address books
template: print an empty yaml template

Configuration¶

See khard.conf(5).