Basic interface for pyOSC


SimpleOSC 0.3.2

ixi audio - 13/12/2012

contact us on

Install :
in the command line / terminal type 'python install'. In Unix systems you might need to have root permissions. Windows users can also just copy the file into C:/python/2.x/Lib/site-packages

The main aim is to provide with a simple way to deal with the OSC implementation that makes life easier to newcomers or students. Therefore SimpleOSC is a very simple (and *limited*) API for the Open Sound Control for Python (by V2 --> You must have pyOSC installed for this module to run. We provide with functions to perform the most basic OSC send and receive.

Previous versions of simpleOSC were based on by Daniel Holth, Clinton McChesney.

How to use:
First you need to download and install pyOSC from
Once you have that installed you can start checking the examples provided in SimpleOSC. You can install the module with python install or you can just place the file next to your files
or you copy it manually into the python site-packages folder (if you know where this lives in your system. Note that firewalls and routers tend to block nerwork ports for security. Make sure you use ports that are open for the OSC comunication.

For more details on simpleOSC check its documentation.

Download page:
or go to and get into backyard/code section

License : 
 This library is free software; you can redistribute it and/or modify it under the terms of the Lesser GNU, Lesser General Public License as published by the Free Software Foundation.

This library 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 Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

SimpleOSC contains parts by others such as by V2. Licence and credits are included on those parts from others.

System requirements:
OS X, GNU/Linux, Windows .... with Python and pyOSC installed

About OSC:


- added startOSCServer to solve a weird error that just pop up, example updated as well

- updating example 

- moved from old by Daniel Holth and Clinton McChesney to latest by V2
So everything changes ....

----------- old below ----------

- patch for OSCArgument() in by ondeosfrangosnaotemvez. Checks if the type
of variable is a unicode string, and treats them as a normal string

- thread listener improved by Antony Templier (thanks!)
- removed self.socket.settimeout(1.0) from OSCServer class,
 this apparently caused an error on mac

- added threads to listener area thanks to Christopher Frauenberger.

- added double values thanks to Christopher Frauenberger
- ChucK example added.
- array in sendMsg takes default value to [] to allow for this type of messages

- some optimisation. got rid of some variables and functions

- added

- it sends by default to local host "" ip and port 9000
- it receives by default from local host "" ip and port 9001

- in order to make it simpler to use simpleOSC the callBackManager and ouSockets are now
global variables in the oscAPI module so that the user does not have to deal with them. This
makes the API cleaner and more compact. 

- switched licence to LGPL.

- some tiding up

- removed to make it more general
- and are now a package to make it more compact
- included latest version of