Version 0.2

Instructions to get going

First, make sure that you have the latest version of Kojo installed (this can be obtained from the Kojo download page). Then, follow the steps outlined below.

Quick summary of steps to get going with kojo-music

• Delete the kojo-music directory under ~/.kojo/extension/ if it exists -- to remove an earlier kojo-music installation.
• Download kojo-music.zip and unzip it under ~/.kojo/extension/. This will install kojo-music.

Now you need to update Java soundfonts to make kojo-music sound much better. The steps for this are as follows:

• Download kojo-music-samples.zip and unzip it anywhere you want to.
• Start Kojo, and then open and run workbench.kojo from kojo-music-samples.
• In the UI that shows up in the Drawing Canvas, click on the Update Soundfont button that's located on the bottom left of the canvas. This will make richer sounds available in the Java virtual machine on which Kojo runs. Make sure you carry out this step!
• Restart Kojo and start playing with kojo-music.

That's it!

Detailed instructions for carrying out the above steps are given below:

Install kojo-music

• Go into the directory ~/.kojo/.
• See if there is an extension directory in there. If there isn't, create it.
• Download kojo-music.zip from the link at the bottom of this page.
• Unzip it under ~/.kojo/extension/. This should create a directory called ~/.kojo/extension/kojo-music with a bunch of stuff (including four jar files) inside it.
  • If you already had a directory called ~/.kojo/extension/kojo-music, just overwrite its contents with the above step (or better still, just delete it before you carry out the above step).
• At this point, kojo-music is installed!
• If Kojo is already running, you need to restart it for kojo-music to get picked up.

Run the music workbench to update soundfonts and play some music

• Now start up Kojo.
• The Kojo output pane should mention that 4 additional jars are available under ~/.kojo/extension/kojo-music/.
• Download kojo-music-samples.zip from the link at the bottom of this page, and unzip it somewhere - let's say under ~/work. This will create a directory called ~/work/kojo-music-samples.
• From within Kojo, do a File -> Open, go into ~/work/kojo-music-samples/, and open workbench.kojo.
• Run the workbench.kojo script that you just opened by clicking on the Kojo Run button.
• In the UI that shows up in the Drawing Canvas, click on the Update Soundfont button that's located on the bottom left of the canvas. This will make richer sounds available in the Java virtual machine on which Kojo runs. Make sure you carry out this step!
• Make sure from the text that shows up in the Output Pane that the above step has completed successfully.
• Restart Kojo.
• Once again, from within Kojo, do a File -> Open, go into ~/work/kojo-music-samples, and open workbench.kojo.
• Run the workbench.kojo script that you just opened by clicking on the Kojo Run button.
• In the UI that shows up in the Drawing Canvas, click on the Srv Up button that's located on the bottom left. This will start the Music Server.
• Now click on the Load button, go into ~/work/kojo-music-samples/workbench-scores, and load tune2.score.
• Click on the Play button in the UI.
• Enjoy the music! (and see how the music is defined in the Workbench UI). If the music seems rather slow, increase the tempo in the UI to 200, and then Stop and Play the music.
• Click on the Stop button in the UI to stop the music.

Play some sample music compositions

• Do a File -> Open, go into ~/work/kojo-music-samples/examples, and open score2.kojo.
• Run the score2.kojo script that you just opened by clicking on the Kojo Run button.
• Listen to the simple music that is played, and look at how the code in score2.kojo generates this music.
• Open and run the other files in ~/work/kojo-music-samples/examples as desired.

Version 0.1

Instructions to get going

First, make sure that you have the latest version of Kojo installed (this can be obtained from the Kojo download page). Then, follow the steps outlined below.

Quick summary of steps to get going with kojo-music

• Download kojo-music.zip and unzip it under ~/.kojo/extension/. This will install kojo-music.

Now you need to update Java soundfonts to make kojo-music sound much better. The steps for this are as follows:

• Download kojo-music-samples-160423.zip and unzip it anywhere you want to.
• Start Kojo, and then open and run workbench.kojo from kojo-music-samples.
• In the UI that shows up in the Drawing Canvas, click on the Update Soundfont button that's located on the bottom left of the canvas. This will make richer sounds available in the Java virtual machine on which Kojo runs. Make sure you carry out this step!
• Restart Kojo and start playing with kojo-music.

That's it!

Detailed instructions for carrying out the above steps are given below:

Install kojo-music

• Go into the directory ~/.kojo/.
• See if there is an extension directory in there. If there isn't, create it.
• Download kojo-music.zip from the link at the bottom of this page.
• Unzip it under ~/.kojo/extension/. This should create a directory called ~/.kojo/extension/kojo-music with a bunch of stuff (including four jar files) inside it.
  • If you already had a directory called ~/.kojo/extension/kojo-music, just overwrite its contents with the above step (or better still, just delete it before you carry out the above step).
• At this point, kojo-music is installed!
• If Kojo is already running, you need to restart it for kojo-music to get picked up.

Run the music workbench to update soundfonts and play some music

• Now start up Kojo.
• The Kojo output pane should mention that 4 additional jars are available under ~/.kojo/extension/kojo-music/.
• Download kojo-music-samples-160423.zip from the link at the bottom of this page, and unzip it somewhere - let's say under ~/work. This will create a directory called ~/work/kojo-music-samples.
• From within Kojo, do a File -> Open, go into ~/work/kojo-music-samples/, and open workbench.kojo.
• Run the workbench.kojo script that you just opened by clicking on the Kojo Run button.
• In the UI that shows up in the Drawing Canvas, click on the Update Soundfont button that's located on the bottom left of the canvas. This will make richer sounds available in the Java virtual machine on which Kojo runs. Make sure you carry out this step!
• Make sure from the text that shows up in the Output Pane that the above step has completed successfully.
• Restart Kojo.
• Once again, from within Kojo, do a File -> Open, go into ~/work/kojo-music-samples, and open workbench.kojo.
• Run the workbench.kojo script that you just opened by clicking on the Kojo Run button.
• In the UI that shows up in the Drawing Canvas, click on the Srv Up button that's located on the bottom left. This will start the Music Server.
• Now click on the Load button, go into ~/work/kojo-music-samples/workbench-scores, and load tune2.score.
• Click on the Play button in the UI.
• Enjoy the music! (and see how the music is defined in the Workbench UI). If the music seems rather slow, increase the tempo in the UI to 200, and then Stop and Play the music.
• Click on the Stop button in the UI to stop the music.

Play some sample music compositions

• Do a File -> Open, go into ~/work/kojo-music-samples/examples, and open score2.kojo.
• Run the score2.kojo script that you just opened by clicking on the Kojo Run button.
• Listen to the simple music that is played, and look at how the code in score2.kojo generates this music.
• Open and run the other files in ~/work/kojo-music-samples/examples as desired.

Proof of Concept (PoC)

Instructions to get going

First, make sure that you have the latest version of Kojo installed (Version: 2.9.23 r4 - at the time of this writing). Then, follow the steps outlined below.

Install kojo-music

• Go into the directory ~/.kojo/.
• See if there is an extension directory in there. If there isn't, create it.
• Download kojo-music.zip from the link at the bottom of this page.
• Unzip it under ~/.kojo/extension/. This should create a directory called ~/.kojo/extension/kojo-music with a bunch of stuff (including four jar files) inside it.
• At this point, kojo-music is installed!
• If Kojo is already running, you need to restart it for kojo-music to get picked up.

Run the music workbench

• Now start up Kojo.
• The Kojo output pane should mention that 4 additional jars are available under ~/.kojo/extension/kojo-music/.
• Download kojo-music-samples.zip from the link at the bottom of this page, and unzip it somewhere - let's say under ~/work. This will create a directory called ~/work/kojo-music-samples.
• From within Kojo, do a File -> Open, go into ~/work/kojo-music-samples/, and open workbench.kojo.
• Run the workbench.kojo script that you just opened by clicking on the Kojo Run button.
• In the UI that shows up in the Drawing Canvas, click on the Update soundfont button that's located on the bottom left (to make richer sounds available in the Java virtual machine on which Kojo runs).
• Make sure from the text that shows up in the Output Pane that the above step has completed successfully.
• Restart Kojo.
• Once again, from within Kojo, do a File -> Open, go into ~/work/kojo-music-samples, and open workbench.kojo.
• Run the workbench.kojo script that you just opened by clicking on the Kojo Run button.
• In the UI that shows up in the Drawing Canvas, click on the Srv Up button that's located on the bottom left. This will start the Music Server.
• Now click on the Load button, go into ~/work/kojo-music-samples/workbench-scores, and load tune2.score.
• Click on the Play button in the Drawing Canvas.
• Enjoy the music! (And see how the music is defined in the Workbench UI).
• Click on the Stop button in the Drawing Canvas to stop the music.

Run some samples

• Do a File -> Open, go into ~/work/kojo-music-samples/examples, and open score2.kojo.
• Run the score2.kojo script that you just opened by clicking on the Kojo Run button.
• Listen to the simple music that is played, and look at how the code in score2.kojo generates this music.
• Open and run the other files in ~/work/kojo-music-samples/examples as desired.