Tutorial: getting started with OSCream on the BlackBerry PlayBook

March 30th, 2011 § 20 Comments

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.


  • 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

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 :-)
PlayBook 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 :-)

OSCream Server

March 27th, 2011 § Leave a Comment

OSCream Server is used to forward OSC Message between TCP protocol and UDP protocol.

OSCreamServer 1.0 on Windows 7

On the PlayBook, OSCream is developped in Adobe AIR environment, for security reasons UDP communication is disabled in AIR on mobile devices, so OSCream send its OSC Messages over TCP. But most monome applications are designed to exchange OSC messages over UDP, so a tool is needed to allow application to communicate with the PlayBook, OSCreamServer does just that.

OSCream Server is programmed in Java, so it will run on any machine where a Java Runtime Environment is available, you will need Java version 1.6. OSCreamServer is distributed as a single JAR file, to run OSCreamServer, simply double-click on the JAR file icon.


latest version is 1.1, download OSCreamServer-1.1.jar now from our GitHub repository.
version 1.0, download OSCreamServer-1.0.jar now from our GitHub repository.

Source Code

OSCream Server source code is available on GitHub.

OSCream published on BlackBerry AppWorld

March 24th, 2011 § Leave a Comment

I did it!

I just finished the submission process for the first version of OSCream for BlackBerry PlayBook. Now waiting for approval from AppWorld.

It has been quite challenging to learn development for a new platform, I had never used Adobe Flex nor ActionScript before, and I really enjoyed it. I hope you’ll enjoy the application too :-)

Shortly, OSCream is intended to be a multi-usage OSC remote controller, ideally something like a lemur. Right now it only supports one simple surface, though very rich in possibility, MN8x8 is in fact a Monome 64 emulator, I have tested it with various Monnome application on MAX and PureData and I’m very happy with the results, I had never had a chance to use a Monome before so this was really all new to me.

Well it’s quite late here so I’ll leave it here for today, I wish OSCream good luck on RIM’s AppWorld and hope it will have many more surfaces to play with in a near future.

Where Am I?

You are currently viewing the archives for March, 2011 at Smugrik.org.