.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "KHARD.CONF" "5" "Apr 06, 2024" "0.19" "khard" .SH NAME khard.conf \- configuration file for khard .SH SUMMARY .sp The config file for \fBkhard\fP is a plain text file with an ini\-like syntax. Many options have a corresponding command line option. The only mandatory section in the config file is the definition of the available address books. .SH LOCATION .sp The file is looked up at \fB$XDG_CONFIG_HOME/khard/khard.conf\fP\&. If the environment variable \fB$XDG_CONFIG_HOME\fP is unset \fB~/.config/\fP is used in its stead. .sp The location can be changed with the environment variable \fB$KHARD_CONFIG\fP or the command line option \fI\%\-c\fP (which takes precedence). .SH SYNTAX .sp The syntax of the config file is ini\-style dialect. It is parsed with the configobj library. The precise definition of the corresponding ini syntax can be found at \fI\%https://configobj.readthedocs.io/en/latest/configobj.html#the\-config\-file\-format\fP \&. .sp It supports sections marked with square brackets and nested sections with more square brackets. Each section contains several keys with values delimited by equal signs. The values are typed and type checked. .SH OPTIONS .sp The config file consists of these four sections: .INDENT 0.0 .TP .B addressbooks This section contains several subsections, but at least one. Each subsection can have an arbitrary name which will be the name of an addressbook known to khard. Each of these subsections \fBmust\fP have a \fIpath\fP key with the path to the folder containing the vCard files for that addressbook. The \fIpath\fP value supports environment variables and tilde prefixes. \fBkhard\fP expects the vCard files to hold only one VCARD record each and end in a \fB\&.vcf\fP extension. .TP .B general This section allows one to configure some general features about khard. The following keys are available in this section: .INDENT 7.0 .IP \(bu 2 \fIdebug\fP: a boolean indication whether the logging level should be set to \fIdebug\fP by default (same effect as the \fI\%\-\-debug\fP option on the command line) .IP \(bu 2 \fIdefault_action\fP: the default action/subcommand to use if the first non option argument does not match any of the available subcommands .IP \(bu 2 \fIeditor\fP: the text editor to use to edit address book entries, if not given \fB$EDITOR\fP will be used .IP \(bu 2 \fImerge_editor\fP: a command used to merge two cards interactively, if not given, \fB$MERGE_EDITOR\fP will be used .UNINDENT .TP .B contact table This section is used to configure the behaviour of different output listings of khard. The following keys are available: .INDENT 7.0 .IP \(bu 2 \fIdisplay\fP: which part of the name to use in listings; this can be one of \fBfirst_name\fP, \fBlast_name\fP or \fBformatted_name\fP .IP \(bu 2 \fIgroup_by_addressbook\fP: whether or not to group contacts by address book in listings .IP \(bu 2 \fIlocalize_dates\fP: whether to localize dates or to use ISO date formats .IP \(bu 2 \fIpreferred_email_address_type\fP: labels of email addresses to prefer .IP \(bu 2 \fIpreferred_phone_number_type\fP: labels of telephone numbers to prefer .IP \(bu 2 \fIreverse\fP: whether to reverse the order of contact listings or not .IP \(bu 2 \fIshow_nicknames\fP: whether to show nick names .IP \(bu 2 \fIshow_uids\fP: whether to show uids .IP \(bu 2 \fIshow_kinds\fP: whether to show kinds .IP \(bu 2 \fIsort\fP: field by which to sort contact listings .UNINDENT .TP .B vcard .INDENT 7.0 .IP \(bu 2 \fIprivate_objects\fP: a list of strings, these are the names of private vCard fields (starting with \fBX\-\fP) that will be loaded and displayed by khard .IP \(bu 2 \fIsearch_in_source_files\fP: whether to search in the vCard files before parsing them in order to speed up searches .IP \(bu 2 \fIskip_unparsable\fP: whether to skip unparsable vCards, otherwise khard exits on the first unparsable card it encounters .IP \(bu 2 \fIpreferred_version\fP: the preferred vCard version to use for new cards .UNINDENT .UNINDENT .SH EXAMPLE .sp This is the \fBexample config file\fP: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C # example configuration file for khard version > 0.14.0 # place it under ~/.config/khard/khard.conf # This file is parsed by the configobj library. The syntax is described at # https://configobj.readthedocs.io/en/latest/configobj.html#the\-config\-file\-format [addressbooks] [[family]] path = ~/.contacts/family/ [[friends]] path = ~/.contacts/friends/ [general] debug = no default_action = list # These are either strings or comma seperated lists editor = vim, \-i, NONE merge_editor = vimdiff [contact table] # display names by first or last name: first_name / last_name / formatted_name display = first_name # group by address book: yes / no group_by_addressbook = no # reverse table ordering: yes / no reverse = no # append nicknames to name column: yes / no show_nicknames = no # show uid table column: yes / no show_uids = yes # show kind table column: yes / no show_kinds = no # sort by first or last name: first_name / last_name / formatted_name sort = last_name # localize dates: yes / no localize_dates = yes # set a comma separated list of preferred phone number types in descending priority # or nothing for non\-filtered alphabetical order preferred_phone_number_type = pref, cell, home # set a comma separated list of preferred email address types in descending priority # or nothing for non\-filtered alphabetical order preferred_email_address_type = pref, work, home [vcard] # extend contacts with your own private objects # these objects are stored with a leading \(dqX\-\(dq before the object name in the vcard files # every object label may only contain letters, digits and the \- character # example: # private_objects = Jabber, Skype, Twitter # default: , (the empty list) private_objects = Jabber, Skype, Twitter # preferred vcard version: 3.0 / 4.0 preferred_version = 3.0 # Look into source vcf files to speed up search queries: yes / no search_in_source_files = no # skip unparsable vcard files: yes / no skip_unparsable = no .ft P .fi .UNINDENT .UNINDENT .SH COPYRIGHT 2024, Eric Scheibler .\" Generated by docutils manpage writer. .