Update README.md

[miniband.git] / README.md

diff --git a/README.md b/README.md
index 44ed82b6bcacfc5624c7fbb29fcc5d55319d2152..5935ab2230f7ea1e9e1cca5aa854229b664ebe72 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
 
@@ -135,3 +141,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. 
+