Update README.md

[miniband.git] / README.md

diff --git a/README.md b/README.md
index 44ed82b6bcacfc5624c7fbb29fcc5d55319d2152..a9a90f80969c3a09cbd6d3e10fbd432fd0ed0851 100644 (file)
--- a/README.md
+++ b/README.md
@@ -25,6 +25,7 @@ Learn how to build circuits with sensors and outputs and write a simple programm
 * Electrical tape
 * Plastic drinking straw
 * Pencil
+* Coloured pens (optional)
 
 
 ## Software requirements:
@@ -54,11 +55,15 @@ A better explanation can be found [here](http://arduino.cc/en/Tutorial/DigitalPi
 
 ## Drum Kit
 
+<img src="http://farm9.staticflickr.com/8074/8257699966_7585ca06e7.jpg" width="375" height="500" alt="Code Club Miniband"><
+
 ### 1. Make your drums
 
 Take your 4 piezo buzzers and attach a ring of Sugru (or other modelling material) as shown in the picture. 
 This will increase the flexibility and resonance of the sensors. Let the sugru set.
 
+<img src="http://farm9.staticflickr.com/8353/8256628815_6c3872d3ac.jpg" width="500" height="375" alt="Code Club Miniband">
+
 
 ### 2. Connect the circuit
 
@@ -67,6 +72,7 @@ Connect one lead from your buzzer to one of your analogue inputs, and connect th
 Repeat for each of your drums. It is easiest to use a bread board for making your circuit. 
 Look at the picture for an example.
 
+<img src="http://farm9.staticflickr.com/8081/8256628955_f65a76b6fb.jpg" width="500" height="375" alt="Code Club Miniband">
 
 ### 3. Program the Arduino
 
@@ -80,6 +86,8 @@ Find four different drum sounds (or whatever sounds you'd like your drums to mak
 
 ## Guitar
 
+<img src="http://farm9.staticflickr.com/8070/8257698984_8471e4cf57.jpg" width="500" height="375" alt="Code Club Miniband">
+
 ### 1. Make your guitar
 
 Grab your strip potentiomater, a piece of thin card, and a pencil. 
@@ -97,6 +105,7 @@ the fretboard runs (high and the top, low at the bottom or vice-versa).
 
 Signal will come from the centre pin, so connect that to one of your analogue inputs and you should be good to go.
 
+<img src="http://farm9.staticflickr.com/8363/8257699194_a2645e0e06.jpg" width="500" height="375" alt="Code Club Miniband">
 
 ### 3. Program the Arduino
 
@@ -135,3 +144,16 @@ Find the appropriate code from the respository and upload to your Ardunio board.
 Find a maraca / shaker sound and upload to Scratch.
 
 
+## Python glueware
+
+Download the music-maker-hander.py file from the repository. Run it with
+ python music-maker-handler.py
+This program sets up a listener for each instrument. When it detects that an instrument has been played, it sends a couple of signals to Scratch.
+The first signal appears in Scratch as a sensor value and is the volume (for drums), pitch (for the guitar), or ignored (for the maracas).
+The second signal is a broadcast message that makes Scratch play the sound in the instrument.
+
+
+## Scratch front end
+
+The Scratch file, music-maker, makes the sounds. It responds to the signals from the Python handler above by playing the appropriate sounds. It also does some visual feedback for the insturments. 
+