diff --git a/.gitignore b/.gitignore
index ff83f2f..0f950b1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -25,4 +25,5 @@ _testmain.go
 
 
 twitterConfig.json
+build/twitterConfig.json
 temp
diff --git a/README.md b/README.md
index f263020..1df9555 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,22 @@
 # goTweetsAnalyze
 twitter analyzer written in Go lang
+
+needs a .json file with the content:
+```
+{
+    "consumer_key": "xxxxxxxxxxxxxxxx",
+    "consumer_secret": "xxxxxxxxxxxxxxxx",
+    "access_token_key": "xxxxxxxxxxxxxxxx",
+    "access_token_secret": "xxxxxxxxxxxxxxxx"
+}
+
+```
+
+to run it:
+- go to the /build folder
+- open terminal
+- execute the script with:
+```
+./goTweetsAnalyze
+```
+- follow the instructions