diff --git a/README.md b/README.md
index 31e06d9..c5c85cd 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,11 @@
-# ocrd_calamari
\ No newline at end of file
+# ocrd_calamari
+
+Recognize text using [Calamari OCR](https://github.com/Calamari-OCR/calamari).
+
+Introduction
+-------------
+
+This offers a OCR-D compliant workspace processor for some of the functionality of Calamari OCR.
+
+This processor only operates on the text line level and so needs a line segmentation (and by extension a binarized 
+image) as its input.