diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2aebf9b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# r34-scraper
+
+a scraper that well scrapes r34 
+
+## note 
+
+this thing is still not completed, it only gathers links from the first page currently and doesn't download anything
+
+it's pretty much almost completed though, i only need to add some more features like making it go through all the pages, selecting tags and downloading to somewhere