--- a/README.md	Sat Jan 20 23:19:16 2018 +0000
+++ b/README.md	Sat Jan 20 23:50:36 2018 +0000
@@ -1,8 +1,26 @@
+# Borgend
+
 This is a retrying and queuing scheduler as well as a MacOS tray icon for [BorgBackup](https://borgbackup.readthedocs.io/en/stable/).
 
 The lead author is Tuomo Valkonen (<tuomov@iki.fi>).
 
-# LICENSE
+## Installation
+
+You will need to install the following non-standard Python packages:
+
+ - [rumps](https://github.com/jaredks/rumps) (Ridiculously Uncomplicated macOS Python Statusbar apps)
+ - [keyring](https://pypi.python.org/pypi/keyring)
+
+## Usage
+
+### Passphrases
+
+Passphrases are stored in the OS X Keychain (or whatever the keyring package support on other systems). In the Borgend configuration file, you only configure the ‘account’ of the of the password using `keychain_account` keyword of each backup set. The ‘service’ of the password has to be `borg-backup`. To add a password into the keychain for the ‘my-borg-backup’, you may use:
+
+    security add-generic-password -a my-borg-backup -s borg-backup -w [PASSWORD]
+
+
+## License
 
 This software is distributed under an ANTI-ABUSE LICENSE (aka. *fuck copyright and fuck distributions license*), and without any warranty whatsoever. If you redistribute this software as part of a larger collection/distribution/suite of software, you must do either of the following:
 
@@ -13,3 +31,4 @@
 (b) Rename the software, and make it obvious that your modified or obsolete software is in no way connected to the lead author of the original software. The users of your version should under no circumstances be under the illusion that they can contact the lead author or any of the authors of the original software if they have any complaints or queries.
 
 Otherwise, do whatever you want with this software.
+