diff --git a/README.MD b/README.MD
new file mode 100644
index 0000000..10b6cae
--- /dev/null
+++ b/README.MD
@@ -0,0 +1,17 @@
+# A selection of information output tools for dmenu
+
+These are a selection of independant tools for displaying various information 
+about system status in dmenu. Some of them i.e. `volume` have options (up, down, mute...) 
+which are selectable options in dmenu.  
+ 
+They are compiled separately, for example:
+```nim
+nim c pingclock
+```
+
+Personally, I have these bound to key combinations in i3. In fact, I have a seperate `bindsym` mode in which all these tools are accessible i.e. `$mod+i` to get to "info" mode then `p` to show pingclock.  
+There's also an i3bar_tools_threaded folder with tools for use with i3bar/i3blocks which continously update. Currently these are not working as I recently switched from this as primary, to a secondary choice.  
+
+These have some configuration variables explicit to me, you'll need to change them for you for them to be useful I imagine.  
+
+I'm aware my code is messy. I'm aware my code is undocumented. But hopefully these things are simple enough to work out.
diff --git a/fuzzytime.nim b/fuzzytime.nim
old mode 100644
new mode 100755
diff --git a/i3bar_tools/i3bar_brightness_threads.nim b/i3bar_tools_threaded/i3bar_brightness_threads.nim
similarity index 100%
rename from i3bar_tools/i3bar_brightness_threads.nim
rename to i3bar_tools_threaded/i3bar_brightness_threads.nim
diff --git a/i3bar_tools/i3bar_date_threads.nim b/i3bar_tools_threaded/i3bar_date_threads.nim
similarity index 100%
rename from i3bar_tools/i3bar_date_threads.nim
rename to i3bar_tools_threaded/i3bar_date_threads.nim
diff --git a/i3bar_tools/i3bar_nic_threads.nim b/i3bar_tools_threaded/i3bar_nic_threads.nim
similarity index 100%
rename from i3bar_tools/i3bar_nic_threads.nim
rename to i3bar_tools_threaded/i3bar_nic_threads.nim
diff --git a/i3bar_tools/i3bar_tides_threads.nim b/i3bar_tools_threaded/i3bar_tides_threads.nim
similarity index 100%
rename from i3bar_tools/i3bar_tides_threads.nim
rename to i3bar_tools_threaded/i3bar_tides_threads.nim
diff --git a/i3bar_tools/i3bar_volume_threads.nim b/i3bar_tools_threaded/i3bar_volume_threads.nim
similarity index 100%
rename from i3bar_tools/i3bar_volume_threads.nim
rename to i3bar_tools_threaded/i3bar_volume_threads.nim
diff --git a/i3bar_tools/i3bar_wlan_threads.nim b/i3bar_tools_threaded/i3bar_wlan_threads.nim
similarity index 100%
rename from i3bar_tools/i3bar_wlan_threads.nim
rename to i3bar_tools_threaded/i3bar_wlan_threads.nim
diff --git a/volume.nim b/volume.nim
old mode 100644
new mode 100755