Added the all important play.py file which was missing from the repository.

Author: dhilowitz

.gitignore

@@ -7,7 +7,7 @@
 !/examples/*
 !/grid_instrument
 !/grid_instrument/*
-
+!play.py
 !README.md
 !MANIFEST.in
 !LICENSE.txt

MANIFEST.in

@@ -1,5 +1,6 @@
 include examples/simple.py
 include examples/threading.py
 include examples/midi_output.py
+include play.py
 include README.rst
 include LICENSE

README.md

@@ -3,8 +3,11 @@ GridInstrument (aka Launchpad Scale-mode)
 
 Did you ever wish you could use your Launchpad as a MIDI instrument? Do you covet the **Scale Mode** on the Launchpad Pro or Ableton Push, but not have the cash to buy them? Now you can play scales on any Novation Launchpad. 
 
+
 Here's a quick [video demo](https://youtu.be/JJA2fm-2NVg).
 
+**There is also an iOS app version of this code [here](https://itunes.apple.com/us/app/gridinstrument/id1296511558?mt=8).**
+
 At it's core, **GridInstrument** is a library that allows you to display a scale grid on your Novation Launchpad. It functions very similarly to the scale mode on Henri David's _fantastic_  [Launchpad95](http://motscousus.com/stuff/2011-07_Novation_Launchpad_Ableton_Live_Scripts/) scripts for Ableton Live, and also similarly to the [scale mode](https://global.novationmusic.com/launchpad-pro-scale-mode) on a Launchpad Pro.
 
 Features:
@@ -24,7 +27,7 @@ Before you try to do anything, make sure you have **Python 2** and **pip** insta
 
 Download the source code from github and install prerequisites:
 
-    git clone https://github.com/GridInstrument
+    git clone https://github.com/dhilowitz/GridInstrument
     cd GridInstrument; pip install launchpad_rtmidi_py
 
 Run the app:
@@ -41,7 +44,7 @@ You have two options for how to install it.
 
 Download the source code from github:
 
-    git clone https://github.com/GridInstrument
+    git clone https://github.com/dhilowitz/GridInstrument
     cd GridInstrument
 
 Install it:

play.py

@@ -0,0 +1,34 @@
+#!/usr/bin/python
+#
+# Quick usage example of "grid_instrument" with MIDI output port.
+# Works with all Launchpads: Mk1, Mk2, S/Mini, Pro, XL and LaunchKey
+# 
+#
+# David Hilowitz 1/15/19
+# decided.ly / davehilowitz.com
+#
+
+import grid_instrument
+import rtmidi
+import time
+
+def note_callback(messageType, midiNote, velocity):
+	if messageType is "note_on":
+		midiout.send_message([0x90, midiNote, velocity])
+	elif messageType is "note_off":
+		midiout.send_message([0x80, midiNote, velocity])
+
+# Create a MIDI output port
+midiout = rtmidi.MidiOut()
+midiout.open_virtual_port("Grid Instrument (Virtual Port)")
+
+# Set up GridInstrument
+instrument = grid_instrument.GridInstrument()
+instrument.intro_message = 'grid'
+instrument.note_callback = note_callback
+instrument.launchpad_pro_velocity_multiplier = 2.5
+instrument.min_velocity = 100
+instrument.max_velocity = 100
+instrument.default_velocity = 100
+
+instrument.start()