diff --git a/README b/README
index d6ed460..87440cd 100644
--- a/README
+++ b/README
@@ -1 +1,25 @@
-This file was created by PyCharm 2.7.3 for binding GitHub repository
\ No newline at end of file
+Twister Python scripts
+======================
+
+These are some random scripts for Twister.
+Prerequisites:
+
+* Python 3.3.x (might work with 3.2 but it's untested. Probably won't work with 2.x)
+* [python-bitcoinrpc](https://github.com/jgarzik/python-bitcoinrpc)
+* [feedparser](https://pypi.python.org/pypi/feedparser) (`pip install feedparser` will work) -- this is for twistmonitor.py only
+
+HELP!
+=====
+
+Feel free to contribute! 
+In particular, map.html is the template for the [map of Twister users](http://static.pythonaro.com/twistmap/) 
+and could do with some love. For simple tests, just replace
+
+    var locations = [];
+
+with
+
+    var locations = [ 
+        ['<h4>Some Location - 123</h4><small>someuser, someotheruser</small>', 34.0659329, -84.6768796],
+        ['<h4>Some Other Location - 456</h4><small>somenick, someothernick</small>', 52.3702157, 4.895167900000001],
+      ];