readme complete

Author: faltastic

README.md

@@ -4,16 +4,20 @@
 
 ![alt](https://raw.githubusercontent.com/faltastic/pixelSortLive/master/screenshots/main.jpg)
 
- ### What is this?
+## What is this?
+
 This sketch performs pixel sorting on a collection of photo sets. It was built to be used in live performances.
 
-* It runs on [Processing](https://processing.org/). 
+* It runs on [Processing](https://processing.org/) (2). 
 * For the GUI, I use [controlP5](http://www.sojamo.de/libraries/controlP5/) which works ok on Processing 2 but not 3. 
 * The sorting algorithim used is [this sketch](https://github.com/phillipdavidstearns/aYearInCode/blob/master/Processing%202.2.1/cellSort/cellSort.pde) written by Phillip Davis Stearns. 
 
 ## How to Use It?
 
-To add your own photo sets, place them in the data folder and add their names to the photoSets string array at the top of the main sketch
+
+Install the [controlP5 library](http://www.sojamo.de/libraries/controlP5/) and open the sketch in Processing 2.
+
+To add your own photo sets, place them in the data folder and add them to photoSets at the top of the main sketch
 
 ```processing
 String[] photoSets = {
@@ -29,10 +33,51 @@ That's it!
 
 ![alt](https://raw.githubusercontent.com/faltastic/pixelSortLive/master/screenshots/gui.jpg)
 
+Let's go through what the control window let's you do:
+
+* Play = play/pause
+* Reload = restart the sorting on the current image
+* Wrap = toggle wrapping pixels on image edges on/off (default: on)
+
+
+* Sort Matrix = the direction in which the sorting is to be done
+* Mode = choose between 6 sorting algorithims 
+ 
+
+* Range = lower and upper brightness thersholds of which pixels to be sorted
+* Sort Flip = flip the sorting thersholds 
+
+
+* Frate = speed control, it really changes the sketch's framerate
+
+
+* No Flip = toggle flipping image in the photoset (default: on)
+* Next Image = load next image in the photoset 
+* Flip Time = set how long it takes between image flips, the higher the value the slower the flip
+
+* Albums = load another album
+
+### Hidden Controls
+
+You can control the size of the display window in the first line in the setup() function
+
+```processing
+ size(1080, 720);
+```
+
+If you want to print out the frames of your animation, press **P** while playing, and the files will be saved in a **prints** folder in *tif* format.
+
+
+## Thanks
+
+To [Kareem Osman](https://vimeo.com/kafkube) for the help testing this code in the wild.
 
 ## License
 
-MIT
+MIT 2017
+
+Basically, you can do whatever you want as long as you include the original copyright and license notice in any copy of the software/source. 
+
+If you use this code in a live show or to make a video, I would love to hear from you. Email me at youssef.faltas@gmail.com 
 
-[![N|Solid](https://cldup.com/dTxpPi9lDf.thumb.png)](https://nodesource.com/products/nsolid)