Groove8 Files

Groove8 is a REST service for generating a MIDI response for a requested note sequence. Web sites created for music education can use Groove8 to dynamically generate musical phrases on-the-fly. 
Copyright 2010 Todd Flanders (tflander@wowway.com)

This is the first pass at creating a Groove8 deployment kit.

Files:

 groove8-0.0.1-SNAPSHOT.war -- Web application archive for Groove8's REST interface.
 groove8_0.0.1.zip -- stand-alone application Groove8's command-line interface.

==============
Rest Interface
==============

The Groove8 WAR file has been tested with Jetty and Tomcat 6 using Java 1.6.

Rest examples (substitute locahost:8080 with the host and port of your deployment):


 - Four Quarters Middle C
http://localhost:8080/groove8/v0.1/C4--- C4--- C4--- C4---

 - Eight Quarters Middle C
http://localhost:8080/groove8/v0.1/C4--- C4--- C4--- C4--- C4--- C4--- C4--- C4---

 - Ascending Scale 2 Bars
http://localhost:8080/groove8/v0.1/[C4... D4... E4... F4---][G4... A4... B4... C5...]

 - Ascending Scale
http://localhost:8080/groove8/v0.1/C4... D4... E4... F4...

 - Spain -- http 500 -- must URL encode sharps
http://localhost:8080/groove8/v0.1/d5 - f#5 d5 e5 d5 b4 d5 - c#5 a4 c#5 - b4 g4 -

 - Latin Groove
http://localhost:8080/groove8/v0.1/G4--D5--G5--D5--G4.G4.

Note: http response is of mime type audio/midi.


======================
Command-Line Interface
======================

Note that only a windows "groove8.bat" file is included, but there is no reason
a UNIX shell script would not also work.  Testing was done using Java 1.6.

Command line examples:


groove8 "|C4---|C4---|C4---|C4---|" -f FourQuartersMiddleC.MID

groove8 "|C4---|C4---|C4---|C4---|C4---|C4---|C4---|C4---|" -f EightQuartersMiddleC.MID

groove8 "[|C4...|D4...|E4...|F4---|][|G4...|A4...|B4...|C5...|]" -f AscendingScale2Bars.MID

groove8 "|C4...|D4...|E4...|F4...|" -f AscendingScale.MID

groove8 "|d5 - f#5 d5| e5 d5 b4 d5 | - c#5 a4 c#5 | - b4 g4 -" -f spain.MID

groove8 "|G4--D5|--G5-|-D5--|G4.G4.|" -f LatinGroove.MID


    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.