This tutorial will help you get started with OSCream on your PlayBook. At the end of this tutorial you will have installed a Monome application on your computer, learned how to configure OSCreamServer on your computer and OSCream on the PlayBook. You will have learned the basics of using a monome to play music.

Requirements:

  • A BlackBerry PlayBook
  • A computer (win or mac will do)
  • Both of the above connected on the same WIFI network
  • Download OSCreamServer
  • Download Max runtime environment - the Max runtime is available for free
  • Download Stretta’s Press Café version 2.1 for monomeserial

Install a Monome Application (Stretta’s Press Café for Max/MSP)

Download and install the Max5 runtime environment. We need it to run Press Cafe.

Unzip Press cafe to the directory of your choice, run the application by launching the file Press Cafe.maxpat, this will launch Press Cafe inside the Max5 Runtime.

Press Cafe application running in Max5 Runtime. Note the prefix in the upper right hand corner.

Connect OSCreamServer

  1. Run OSCream Server on your computer, if your JAVA runtime environment is properly configured, just doubleclicking the OSCreamServer.jar file will launch the app, no need to install anything.
  2. You can leave all the default values, in the PlayBook TCP connection part, note the Port number. Click the Connect button.

OSCreamServer on Windows 7

Connect the PlayBook

  1. Run OSCream on your PlayBook, Swipe-Down the configuration menu from the top of the screen.
  2. In the host field, enter your computer’s IP address
  3. In the port field, enter the port as seen in OSCreamServer Playbook TCP connection section (8090 if you kept the default settings)
  4. In the prefix field type “/press_cafe” as seen in the upper right hand corner of the Press Cafe application.
  5. Switch the connection ON.
  6. Press any button on the PlayBook, hear the music played on your computer by Press Cafe :-)

Press Cafe being played on the blackBerry PlayBook

Going further

The Monome website is the best place to find lots of information about everything Monome. It has a special page referencing all monome applications.

Learn more about the Open Sound Control protocol on opensoundcontrol.org

For this tutorial, we relied on Max/MSP, having the Max/MSP runtime environment set up is a great plus as as many good monome application are running on Max/MSP. But there are many other software that can be used to interface with the Monome. Pure Data is an open source equivalent of Max/MSP, Chuck is a music oriented programming language, or you can start programming your own Monome application in the language of your choice :-)