From d4143414c49cc8e0c4322d5236f9f1301997ce3a Mon Sep 17 00:00:00 2001
From: TiynGER <kantemarten@googlemail.com>
Date: Wed, 1 Apr 2020 00:41:59 +0200
Subject: [PATCH] mutt guide extended

---
 optional/CALENDARCONTACTSMAIL.md | 145 +++++++++++++++++++++++++++++++
 optional/MUTT.md                 |  26 ------
 2 files changed, 145 insertions(+), 26 deletions(-)
 create mode 100644 optional/CALENDARCONTACTSMAIL.md
 delete mode 100644 optional/MUTT.md

diff --git a/optional/CALENDARCONTACTSMAIL.md b/optional/CALENDARCONTACTSMAIL.md
new file mode 100644
index 0000000..56a607a
--- /dev/null
+++ b/optional/CALENDARCONTACTSMAIL.md
@@ -0,0 +1,145 @@
+# Calendar
+To use a terminal calendar the following programs are needed.
+| programm   | description             |
+| ---------- | ----------------------- |
+| khal       | terminal calendar       |
+| vdirsyncer | sync tool for calendars |
+
+## Installation and configuration
+To configure vdirsyncer edit a file in ```~/.config/vdirsyncer/config```.
+
+```
+[general]
+status_path = "~/.cache/vdirsyncer/status"
+
+#calendar
+[pair private_calendar]
+a = "private_calendar_local"
+b = "private_calendar_remote"
+collections = ["from a", "from b"]
+metadata = ["color"]
+
+[storage private_calendar_local]
+type = "filesystem"
+path = "~/.local/share/pim/calendars/private_calendar"
+fileext = ".ics"
+
+[storage private_calendar_remote]
+type = "caldav"
+url = "https://<url>"
+auth = "basic"
+username = "<username>"
+password = "<password>"
+
+```
+
+After that initialize vdirsyncer.
+
+```vdirsyncer discover && vdirsyncer metasync```
+
+And keep regularly syncing your data (crontab).
+The command to sync is the following.
+
+```vdirsyncer sync```
+
+Finally add a ```~/.config/khal/config``` and you're ready to go.
+
+```
+[calendars]
+
+[[calendars]]
+path = ~/.local/share/pim/calendars/*/*
+type = discover
+```
+
+
+# Contacts
+To use a terminal addressbook the following programs are needed.
+| programm   | description             |
+| ---------- | ----------------------- |
+| khard      | terminal addressbook    |
+| vdirsyncer | sync tool for calendars |
+
+## Installation and configuration
+To configure vdirsyncer edit a file in ```~/.config/vdirsyncer/config```.
+
+```
+[general]
+status_path = "~/.cache/vdirsyncer/status"
+
+#contacts
+[pair private_contacts]
+a = "private_contacts_local"
+b = "private_contacts_remote"
+collections = ["from a", "from b"]
+
+[storage private_contacts_local]
+type = "filesystem"
+path = "~/.local/share/pim/contacts"
+fileext = ".vcf"
+
+[storage private_contacts_remote]
+type = "carddav"
+url = "https://<url>"
+username = "<username>"
+password = "<password>"
+auth = "basic"
+```
+
+After that initialize vdirsyncer.
+
+```vdirsyncer discover && vdirsyncer metasync```
+
+And keep regularly syncing your data (crontab).
+The command to sync is the following.
+
+```vdirsyncer sync```
+
+Now you just need to add and configure the config and youre done.
+
+```
+mkdir ~/.config/khard
+cp /usr/share/doc/khard/khard.conf.example ~/.config/khard/khard.conf
+```
+
+# Mutt
+These are a bunch of programs to be able to use lukesmithxyz's mutt-wizard,
+which will be able to setup your neomutt acordingly.
+
+| program     | description           |
+| ----------- | --------------------- |
+| neomutt     | mail program          |
+| isync       | syncs mail            |
+| msmtp       | sends mail            |
+| pass        | encrypts passwords    |
+| mutt-wizard | autoconfigure neomutt |
+
+## Installation and configuration
+After the basic installation you will be able to:
+
+``` mw add ``` to add mailaccounts
+
+``` mw ls ``` to list existing ones
+
+``` mw pass ``` to revise passwords
+
+``` mw delete ``` to delete accounts
+
+``` mw purge ``` to delete all accounts and settings
+
+``` mw cron ``` toggle a cronjob to sync mail
+
+## Use khard in mutt
+To use your khard addressbook in mutt just add the following lines to your ```~/.config/mutt/muttrc```.
+
+```
+set query_command= "khard email --parsable --search-in-source-files %s"
+bind editor <Tab> complete-query
+bind editor ^T complete
+macro index,pager A \
+	"<pipe message>khard add-email<return>" \
+	"add the sender email address to khard"
+```
+
+You can just tab-complete the email-addresses.
+You can also add new ones by pressing A.
diff --git a/optional/MUTT.md b/optional/MUTT.md
deleted file mode 100644
index dfd9aa8..0000000
--- a/optional/MUTT.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# Mutt
-These are a bunch of programs to be able to use lukesmithxyz's mutt-wizard,
-which will be able to setup your neomutt acordingly.
-
-| program     | description           |
-| ----------- | --------------------- |
-| neomutt     | mail program          |
-| isync       | syncs mail            |
-| msmtp       | sends mail            |
-| pass        | encrypts passwords    |
-| mutt-wizard | autoconfigure neomutt |
-
-## Installation
-After the basic installation you will be able to:
-
-``` mw add ``` to add mailaccounts
-
-``` mw ls ``` to list existing ones
-
-``` mw pass ``` to revise passwords
-
-``` mw delete ``` to delete accounts
-
-``` mw purge ``` to delete all accounts and settings
-
-``` mw cron ``` toggle a cronjob to sync mail