--- a/README.rst	Mon Sep 29 16:17:13 2014 +0200
+++ b/README.rst	Mon Sep 29 16:17:45 2014 +0200
@@ -1,4 +1,33 @@
 odfcast
 =======
 
-A conversion http service based on py3o
+A conversion http service based on py3o and PyPDF2
+
+
+Installation
+------------
+
+Install requirements::
+
+    $ pip install -r requirements.txt
+
+
+Run
+---
+
+Start server::
+
+    $ python main.py
+
+Open your webbrowser or user example clients::
+
+    $ ./castclient.py in.odt out.file -f format
+
+    $ ./castclient.py in.odt out.file -f format --json data.json
+
+    $ ./mergeclient.py in1.pdf in2.pdf in3.pdf -o out.pdf
+
+License
+-------
+
+MIT License