Connect xSchedule

Run your show on xSchedule? Here is what the bridge lets you do: pull every night’s setlist and schedule straight onto your box, keep your SET:IQ catalog in step with the sequences you actually have, and show viewers what’s playing live — current song, what’s up next, and the requests they sent in for REQ:IQ. One file does all of it.

Same wall as FPP: xSchedule runs on your home network over plain HTTP, and a cloud website can’t reach it — browsers forbid it. So the bridge reaches out instead. It runs inside xSchedule itself (in the Plugins menu, alongside Remote Falcon), fetches your playlists from SET:IQ, and reports back what’s playing.

Unlike FPP, xSchedule has no plugin manager — it loads a native .dll from its program folder. So there’s exactly one file to download and drop in place. We call the loaded plugin the Elm Ridge Bridge; it serves its own setup page inside xSchedule’s web UI.

What the Elm Ridge Bridge gives you

• SET:IQ Pull — every night’s playlist plus the season schedule, written onto the box in one click.
• Sequence scan — the bridge walks your show folder for .fseq files so pulled playlists point at the real sequences, and SET:IQ never schedules a song you don’t have.
• REQ:IQ live status — while it’s on, the bridge reports the current song, what’s up next, and slots viewer requests into playback. Your viewer page lights up in real time.

Before you start

• xLights / xSchedule 2024 or newer, 64-bit (Windows).
• Internet access from the xSchedule PC — it needs to reach lightsofelmridge.com for Pull, scan reporting, and the REQ:IQ status updates.
• Your .fseq sequences already on the PC (the bridge scans for them).

Step 1: Download the plugin

One file — the native plugin DLL. Save it somewhere you can find it; the next step moves it into place.

Step 2: Install the DLL

1. 1

   Close xSchedule completely

   Fully exit xSchedule — including the system tray. xSchedule reads its plugins at startup, so it must be closed when you drop the file in.
2. 2

   Drop the DLL next to xSchedule.exe

   Put xScheduleSETIQ.dll in the xLights program folder — the same folder as xSchedule.exe (typically C:\Program Files\xLights\). It sits right next to xSchedule so the program finds it on launch.
3. 3

   Start xSchedule and open the Plugins menu

   Launch xSchedule and open the Plugins menu — Elm Ridge Bridge should be listed there. That’s the plugin loaded. Click it to open its setup page.

Step 3: The bridge setup page

Open Plugins → Elm Ridge Bridge and the bridge serves its own page inside xSchedule’s web UI. Everything you need lives here: a spot for your show key, the two main buttons — Scan and Pull — and a status panel that tells you it worked.

• Show key — paste it once. The bridge stores it on this PC and reuses it for every pull.
• Scan folder tree — finds your .fseq files. The status panel shows how many it found.
• Pull from SET:IQ — the blue button. It writes every night’s playlist and the season schedule.
• Status panel — sequences found, last pull time, and whether REQ:IQ is on. Green dots mean you’re good.

Step 4: Push your season into xSchedule

1. 1

   Scan your sequence folder

   On the bridge page, click Scan folder tree. It walks your show folder for .fseq files so the pulled playlists point at the real sequences (anything it can’t find is skipped, not broken). The status panel shows the count when it finishes.
2. 2

   Paste your show key and Pull

   In Studio IQ, open SET:IQ → Send to FPP and click Copy key (the same key works for xSchedule). Paste it into the bridge and click Pull from SET:IQ — it writes every night’s playlist and the season schedule onto the box.
3. 3

   Restart xSchedule to load them

   xSchedule reads its playlists at startup, so close and reopen it once after a pull — your SET:IQ playlists and schedule are now there. Don’t hit Save in xSchedule before restarting, or it overwrites the pulled playlists with the old in-memory ones.

Step 5: Live now-playing and viewer requests

On the bridge page, toggle Enable REQ:IQ. While it’s on, the bridge heartbeats what’s playing up to your REQ:IQ viewer page — the current song, what’s up next, and any viewer-requested songs, which it slots into playback automatically. Toggle it off any time; nothing phones home when it’s disabled.

What leaves the PC

Only your show key, the list of .fseq filenames (for the calendar lock), and — while REQ:IQ is enabled — playback status (current song and what’s up next). No media, no sequence data, no credentials. The key is stored only on this PC and sent only to lightsofelmridge.com over HTTPS. If the key ever leaks, hit Regenerate in the Send to FPP dialog — the old key dies instantly.

Troubleshooting