diff --git a/README.md b/README.md
index 1193f78..f16d889 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,21 @@
-# scan_to_pdf
\ No newline at end of file
+# scan to pdf
+
+read files from "front" and "back" dirs, assume that the stack of appaers has simply been moved to the scan bed again without shuffeling and merge the files into a pdf.
+
+Quick and dirty, using img2pdf and pdftk.
+
+*Do not use outside of trusted environment.*
+
+## Requirements
+
+- pdftk
+- img2pdf
+  
+## Run
+
+    python -m virtualenv venv
+    # venv/scripts/Activate.ps1
+    # source venv/bin/activate
+    pip install -r requirements.txt
+
+    python combine.py
\ No newline at end of file