Skip to content


Subversion checkout URL

You can clone with
Download ZIP
send and receive osc messages via
Branch: master
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
package.json proxies osc messages from standard sockets to the browser using


$ npm install


to expose the proper endpoints from the server, you must pass your instance to

var http = require('http'),
  socketio = require(''),
  osc = require(''),
  server = http.createServer(),
  io = socketio.listen(server);


this will create two namespaces, /osc/servers/:port and /osc/clients/:port, to manage osc servers and osc clients respectively. possible port values are restricted to 6000 to 12000. each namespace can listen or emit message events to receive and send osc messages.

in the example below, we create an osc client/server in the browser and send messages from one to the other. of course, the client or server could be any osc device.

var server = io.connect('http://localhost/osc/servers/8000'),
  client = io.connect('http://localhost/osc/clients/8000');

server.on('message', function(message) {

setInterval(function() {
  client.emit('message', ['/osc/test', 200]);
}, 500);

by default, client devices broadcast to to modify the host value of a client, your client must emit a message containing the host.

client.emit('set-host', DEVICE_IP);


  • to enable multiple clients and servers, port must be passed in through the socket namespace to ensure each device has a unique client socket ( creates only one socket per namespace). host cannot be passed in like port, since does not allow for variable namespace names. this makes creating a graceful connection api difficult. a proper api for managing device hosts and ports would be nice.

  • with lacking variable namespaces, i decided to create hannel name handlers only for ports 6000 - 12000 because i am afraid to see what happens if i create 6x,xxx channels. ideally, i'd like to handle truly variable port values.

Something went wrong with that request. Please try again.