LineUsPlaysKeyboards updates

Author: robertpoll

Python/LineUsPlaysKeyboards.py

@@ -0,0 +1,43 @@
+try:
+    from lineusmusic import Keyboard
+    from lineus import LineUs
+except ImportError:
+    print('\n*** You need to install the lineusmusic module: \'pip install lineusmusic\' ***')
+    exit(1)
+
+# Don't forget to 'pip install lineusmusic' before you run the code.
+
+# Music notation is lower case for natural notes and upper case for sharp, so 'a' is natural a
+# and A is a#. Next, we have the octave, '-' is one octave down and '+' one up. The key is fixed
+# as c major at the moment so this means that the note below c on the keyboard is b-. Lastly we have the duration.
+# The default length is one beat, the length of which is set using set_bpm(), and you can set the length to
+# multiples of this. So, for example a2 is an 'a' note played for two beats. An 'r' indicates a rest of one beat.
+#
+# When you create the Keyboard object it moves Line-us to a 'home' position. This is keyboard
+# specific but for the Volca and Stylophone it's 'c' so the input() is included in the code to allow you to
+# make sure your Line-us is in the right position before playing the song.
+#
+# It's easy to add a new keyboard type (see the LineUsMusic module docs for details) but for now we have
+# support for Stylophone and the Korg VolcaFM (actually it will work for some of the other Volcas too).
+# Line-us can't reach to full range of the Volca keyboard so there are two options keyboard='VolcaFM'
+# and keyboard='VolcaFMLow'. I've included scales for the keyboards we support so you can see what notes
+# you have available.
+
+areFriendsElectric = ('c', 'c', 'g', 'r', 'A-', 'A-', 'f', 'r', 'c', 'c', 'g', 'r', 'A-', 'A-', 'A', 'e')
+closeEncounters = ('g', 'a', 'f', 'f-', 'c')        # only for VolcaFMLow
+
+volca_low_scale = ('f-', 'g-', 'a-', 'b-', 'c', 'd', 'e', 'f', 'g', 'a', 'b', 'c+', 'd+', 'e+')
+volca_scale = ('g-', 'a-', 'b-', 'c', 'd', 'e', 'f', 'g', 'a', 'b', 'c+', 'd+', 'e+', 'f+')
+stylophone_scale = ('a-', 'A-', 'b-', 'c', 'd', 'e', 'f', 'g', 'a', 'b', 'c+', 'd+', 'e+')
+
+song = areFriendsElectric
+
+my_lineus = LineUs()
+my_lineus.connect('line-us.local')
+k = Keyboard(my_lineus, keyboard='Stylophone')
+k.set_bpm(110)
+
+input('Set Line-us to \'c\':')
+
+for song_note in song:
+    k.play_note(song_note)

README.md

@@ -45,14 +45,16 @@ Pandrr has ported our Python example to Node! - check out his GitHub [here](http
 ### Simple Dart Example
 [Source code](Dart/line_us.dart) for a very simple example can be downloaded from [here](../../raw/master/Dart/line_us.dart). You'll need [Dart](https://www.dartlang.org/) installed.
 
-
-### Simple C Sharp Unity Example PopLineus
-C (wrapped in unity for now) implementation of the protocol for Line-us created by solentygraham, check out his GitHub [here](https://github.com/NewChromantics/PopLineus)
-
 ### Simple C Example
 [Source code](C/lineustest.c) for a simple example in C created by Paul Haberli can be downloaded from [here](../../raw/master/C/lineustest.c). The code complies on MACOS using gcc but should be fairly portable. A [Makefile](C/Makefile) is also included so if you have gcc in your path, just type 'make'
 
+### Simple C Sharp Unity Example PopLineus
+C# (wrapped in unity for now) implementation of the protocol for Line-us created by solentygraham, check out his GitHub [here](https://github.com/NewChromantics/PopLineus)
+
 ## Applications and other fun things to do with your Line-us
+### Line-us Music
+We've taught Line-us to play keyboards with some [simple Python3 code](Python/LineUsPlaysKeyboards.py#L1) that can be downloaded from [here](../../raw/master/Python/LineUsPlaysKeyboards.py). It's Python3 only so if you're on a Mac you'll need to install Python3 for it to work. We've put all of the keyboard code into a module, so you will need to istall that using `pip install lineusmusic`. When you install `lineusmusic` you'll also get the `lineus` module, but if you want to install that separately you can `pip install lineus`. As usual, we'd recommend using a virtual environment - my prefenece is [pipenv](https://thoughtbot.com/blog/how-to-manage-your-python-projects-with-pipenv) but there are a few options.
+
 ### Line-us JS Kit
 Write commands in JavaScript and preview the drawing in your browser before sending to Line-us! Created by Alex Kempton, check out his Github [here](https://github.com/funwithtriangles/line-us-js-kit)