Connect xSchedule

Running your show with xLights’ xSchedule? Two pieces connect it to Studio IQ:

• The Elm Ridge Bridge — a tiny program that runs on the same PC as xSchedule. It powers REQ:IQ: live now-playing, Up Next, and viewer requests inserted into your show.
• The season .xml export — a one-click download from SET:IQ that brings your whole season’s schedule into xSchedule.

Why a bridge?

Same story as FPP: xSchedule runs on your home network over plain HTTP, and a cloud website can’t reach it — browsers flat-out refuse. The bridge runs on your side of the fence, talks to xSchedule locally, and talks to Studio IQ over the internet. Hence the name.

Set up the bridge

1. 1

   Put the exe somewhere it can live

   Make a folder like C:\elm-ridge-bridge\ and drop elm-ridge-bridge.exe in it. The bridge keeps its config next to itself.
2. 2

   Get your show key

   In Studio IQ, open SET:IQ → Send to FPP (yes, the dialog says FPP — the key works for xSchedule too) and click Copy key.
3. 3

   Create a .env file next to the exe

   Make a plain text file named .env in the same folder, with these four lines:

   PLAYER=xschedule
   XSCHEDULE_HOST=localhost
   XSCHEDULE_PORT=80
   SHOW_KEY=paste-your-show-key-here

   XSCHEDULE_HOST is where xSchedule’s web interface runs — localhost if the bridge is on the same PC. Match XSCHEDULE_PORT to the port in xSchedule’s web settings (80 is the default).

4. 4

   Run it

   Double-click the exe. A console window opens and starts logging. That window staying open is the bridge running — minimize it, don’t close it.

What you get while it runs

• Now Playing on your viewer page, with live progress.
• Up Next — tonight’s rotation, with viewer requests slotting in after the current song.
• Requests played automatically — inserted into xSchedule one at a time, in request order, with the full pending → playing → played lifecycle.
• Force-play from the REQ:IQ Live tab.
• Hourly sequence sync — which also auto-seeds your song catalog. REQ:IQ works with zero uploads.

Security-wise: the bridge talks to the cloud with your show key only. No database credentials, no passwords on your PC.

Import your SET:IQ season into xSchedule

1. 1

   Export the season .xml

   In Studio IQ: SET:IQ → Send to FPP → Manual download tab, then click “Using xSchedule? Download the season .xml” at the bottom.
2. 2

   Import it into xSchedule

   In xSchedule, import the downloaded .xml — your season’s playlists and schedule come in ready to play.
3. 3

   Re-export when the season changes

   Rebuilt a night in SET:IQ? Download a fresh .xml and re-import.

Troubleshooting