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)*.
