node package manager


Sends osc actions on a schedule. Used to create a daily repeating show (eg. Christmas Lights Display)

oscscheduler works by reading a schedule file written in json. This file specifies a start time and end time for the show which will be run each day.

The show itself is a series of osc actions that will be run in a loop until then end time.


var ShowScheduler = require("oscscheduler");
//Load Show File 
var show = require("./show.json");  // The Show File to Load - More details below 
//set up show 
var thisSchedule = new ShowScheduler(show);
thisSchedule.on("beforeStart", function(){
  //If there are things that need be done before the show starts 
thisSchedule.on("afterEnd", function(){
var currentTime = new Date();
currentTime.setHours(19, 59, 55, 0)
//Schedule the show to start - Optionally pass the current time for testing purposes 
//This line schedules the show to start 

`Format for Show File' - Comments are Not Allowed in Real JSON File show.json

"servers" : { //One or more Servers
"Server1" : {
"Host" : "",
"Port" : 9876
"startTime": "20:00", //Time to start the show
"endTime": "20:01", //Time to end the show
"schedule" : [ // The groups of commands to run when they have finished they will just loop
{"duration": 10, "commands": [ //duration is how long you want the effect to last till the next one
{"server": "Server1", "action": "/CURRENT_VISUAL", "parameters": [{"i":0}] }, //Parameters is an array of typed parameters example [{"i":1}, {"s":"some string"}]
{"server": "Server1", "action": "/CHANGE_GENERATOR_A", "parameters": [{"i":4}]},
{"server": "Server1", "action": "/CHANGE_ALL_OUTPUT_VISUAL", "parameters": [{"i":0}]}
{"duration": 20, "commands": [
{"server": "Server1", "action": "/CURRENT_VISUAL", "parameters": [{"i":1}]},
{"server": "Server1", "action": "/CHANGE_GENERATOR_A", "parameters": [{"i":2}]},
{"server": "Server1", "action": "/CHANGE_ALL_OUTPUT_VISUAL", "parameters": [{"i":1}]}
"onShowEnd" : {"commands":[ //This runs at the end Time to clean up the show
{"server": "Server1", "action": "/CURRENT_VISUAL", "parameters": [{"i":0}]},
{"server": "Server1", "action": "/CHANGE_GENERATOR_A", "parameters": [{"i":0}]},
{"server": "Server1", "action": "/CURRENT_COLORSET", "parameters": [{"i":1}]},
{"server": "Server1", "action": "/CHANGE_ALL_OUTPUT_VISUAL", "parameters": [{"i":0}]}