From 3dca5e078a65bed1bda1f926175f84f0088d440f Mon Sep 17 00:00:00 2001 From: Ben Burwell Date: Sun, 29 Dec 2019 23:48:26 -0500 Subject: initial commit --- README.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..cd278d3 --- /dev/null +++ b/README.md @@ -0,0 +1,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' +``` -- cgit v1.2.3