diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1783fef
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# remotezip
+downloads and extracts remote zip files
+
+```javascript
+var remotezip = require("remotezip");
+remotezip.get({
+    from:"https://example.com/example.zip",
+    toPath:"/some/local/absolute/path"
+});
+```
+
+For non zips there is remotefile.
\ No newline at end of file