diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8780ae1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+thumbnails
+==========
+
+Programmatically generated thumbnails for youtube
+
+## Usage
+
+First run `make`
+
+Then use `./venv/bin/python ./make-screenshot.py`
+
+Usage:
+
+```
+./venv/bin/python ./make-screenshot.py  --help
+usage: make-screenshot.py [-h] [--size {1080p,720p}] html_file
+
+positional arguments:
+  html_file
+
+optional arguments:
+  -h, --help           show this help message and exit
+  --size {1080p,720p}
+```