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("./lib/showScheduler");
//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
    "length" : 30,  //Length of the show before it loops
    "schedule" : [ // The groups of commands to run 
        {"start": 10, "commands": [ //start is the number of seconds from the beginning of the loop
            {"server": "Server1", "action": "/CURRENT_VISUAL", "parameter": 0},
            {"server": "Server1", "action": "/CHANGE_GENERATOR_A", "parameter": 4},
            {"server": "PixelController", "action": "/CHANGE_ALL_OUTPUT_VISUAL", "parameter": 0}
        {"start": 20, "commands": [
            {"server": "PixelController", "action": "/CURRENT_VISUAL", "parameter": 1},
            {"server": "PixelController", "action": "/CHANGE_GENERATOR_A", "parameter": 2},
            {"server": "PixelController", "action": "/CHANGE_ALL_OUTPUT_VISUAL", "parameter": 1}
    "onShowEnd" : {"commands":[ //This runs at the end Time to clean up the show
        {"server": "PixelController", "action": "/CURRENT_VISUAL", "parameter": 0},
        {"server": "PixelController", "action": "/CHANGE_GENERATOR_A", "parameter": 0},
        {"server": "PixelController", "action": "/CURRENT_COLORSET", "parameter": 1},
        {"server": "PixelController", "action": "/CHANGE_ALL_OUTPUT_VISUAL", "parameter": 0}