diff --git a/readme.md b/readme.md
--- a/readme.md
+++ b/readme.md
@@ -4,9 +4,29 @@ Implements [Shamir's secret sharing algo
 
 Outputs the shares as hexadecimal, Base32 or Base64 encoded strings.
 
-## Installation and usage ##
+## Installation ##
+
+### From pip
+
+Run `pip install shamira`.
+
+### From the source
+Can be run straight from the cloned repository by executing the package with `python -m shamira` or simply installed with `python setup.py build`, `python setup.py install`. Then imported in your code with `import shamira` or run from the command line with `shamira`.
+
+## Usage
 
-Can be run straight from the cloned repository by executing the package with `python -m shamira` or simply installed with `python setup.py build`, `python setup.py install`. Then imported in your code with `import shamira` or run from the command line with `shamira`.
+### As a CLI application
+
+Run `shamira split ...` for splitting and `shamira join ...` for joining the shares back. Appending `--help` will show you the documentation.
+
+### As a library
+
+`from shamira import generate, generate_raw, reconstruct, reconstruct_raw`
+
+`help(function)` will show the documentation. 
+
+## Issue tracker
+Please report your issues to https://trac.19x19.cz/shamira/report
 
 ## Performance ##