aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: cd278d3177ce6af0f24a17f32cd7455d2b1fef31 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# cdc - a CardDAV Completer

For use with [aerc](https://aerc-mail.org), [mutt](http://www.mutt.org), etc.

## Installation

Use `go get bnbl.io/cdc` to install. Next, simply create a configuration file at
`$XDG_CONFIG_DIR/cdc/confg`, which by default is `$HOME/.config/cdc/config`.

```toml
endpoint = "https://carddav.example.com/dav/users/me@example.com/Default"
username = "your-username@example.com"
password-cmd = "pass your-username@example.com"
```

## Usage

Search for contacts by running `cdc search-term`. cdc writes results in a format
which is understood by aerc's and mutt's address book features. To configure
aerc to use cdc for completion, add the following to ~/.config/aerc/aerc.conf:

```
[compose]
address-book-cmd=cdc '%s'
```