Skip to main content

Simulator: Quickstart

  1. Open the simulator.

  2. Click the Spaces button in the upper right to create a new space:

  1. Got a picture of your house? Drag the file onto the screen to upload it!
  1. Add some lights! Hold your mouse down and drag to decorate. Hit the Enter key to save the lights to a channel.

You can also click on strands to move them, reassign them to different channels, or remove them by pressing Delete.

Key concepts​

We'll get more into the features later. Right now, want to introduce you to a couple key concepts before we move on to sequencing.

Channels​

lightshowd is a music-first platform. Lights are mapped to channels (which could represent a GPIO pin on controller), and channels are mapped to __ notes __. A single note could be assigned to multiple channels, or multiple notes could be assigned to a single channel. Up to you.

If you go back to the Space menu button, and click "Configure", you'll see we've set up a few channels for you.

The values under these three columns: "Client", "Channel", and "Note" can all be customized to your liking. A client could be an AC outet box or an ESP controller connected to pixels, each one with a unique id. In a physical setup, the client would connect to the show server, and the server would message back the assigned notes for each channel.

For now let's get to sequencing. You can come back this when you are ready to design your show.