Skip to main content
8 min read

Connect FPP

One plugin connects your FPP box to SET:IQ and REQ:IQ. Install it once, click Pull, done.

Here's the problem the plugin solves: your FPP box lives on your home network, speaks plain HTTP, and the internet can't reach it. A cloud website like Studio IQ literally cannot talk to it — browsers forbid it. So instead of us reaching in, the plugin reaches out. It runs on the FPP box itself, fetches your playlists from SET:IQ, and reports back what's playing for REQ:IQ.

The plugin is called fpp-SETIQ, and it gives you:

  • SET:IQ Pull — every night's playlist plus the season schedule, created on the box in one click.
  • REQ:IQ listener — your viewer page shows what's playing live, and viewer requests slot into playback automatically.
  • Sequence sync — the box reports its .fseq list back, so SET:IQ never schedules a song you don't actually have. No more 7 PM surprises.

Before you start

  • FPP 8.0 or newer (we test against 9.x).
  • Internet access from the FPP box — it needs to reach lightsofelmridge.com.
  • Nothing to build or compile. It's plug and play. Mostly plug.

Step 1: Install the plugin

The plugin lives in its own GitHub repository (github.com/diaquas/fpp-SETIQ). You don't need to download anything from there by hand — FPP's Plugin Manager installs straight from the repo:

  1. 1

    Open FPP's Plugin Manager

    In the FPP web UI, go to Content Setup → Plugin Manager.
  2. 2

    Find SET:IQ in the plugin list

    Look for SET:IQ + REQ:IQ by Lights of Elm Ridge and click Install.

    Don't see it in the list? Paste this manifest URL into the Plugin Manager's install-by-URL field instead:

    https://raw.githubusercontent.com/diaquas/fpp-SETIQ/main/pluginInfo.json
  3. 3

    Restart fppd when prompted

    FPP asks to restart its daemon after most plugin installs. Let it. New menu entries appear under Content Setup: SET:IQ - Pull from SET:IQ, SET:IQ - Import Playlists, and REQ:IQ - Viewer Requests.

Step 2: Pull your playlists (SET:IQ)

  1. 1

    Copy your show key from SET:IQ

    In Studio IQ, open SET:IQ → Send to FPP and stay on the Automatic tab. Click Copy key.
  2. 2

    Paste it into the plugin

    On the FPP box, open Content Setup → SET:IQ - Pull from SET:IQ, paste the key, and click Pull from SET:IQ.
  3. 3

    That's it — check your playlists

    Every night of your season now exists under Content Setup → Playlists, and the season schedule is written into FPP's Scheduler. Changed your season in SET:IQ? Just Pull again — same-named playlists update cleanly.

About schedule sync

Pull writes one loop-until-end Scheduler entry per show night (plus after-hours entries if you use them). It only touches this show's entries — your background-lights schedule and anything else you've set up stays put.

Keeping the sequence list fresh

Just copied new .fseq files to the box? Click Sync sequence list only on the Pull page. SET:IQ re-checks what's on the box and unlocks those songs on your calendar without re-importing playlists.

No internet on the box? The manual path

  1. 1

    Download the bundle from SET:IQ

    In Studio IQ: SET:IQ → Send to FPP → Manual download → Download FPP bundle. You get a ZIP with one .json playlist per night.
  2. 2

    Upload the files to FPP

    Unzip, then in FPP go to Content Setup → File Manager → Select Files and upload the .json files.
  3. 3

    Import them

    Open Content Setup → SET:IQ - Import Playlists and click Import. Each uploaded file becomes a real FPP playlist.

Step 3: Turn on viewer requests (REQ:IQ)

  1. 1

    Make sure your show key is set

    One key serves both tools. If you already did the Pull setup, you're done with this step.
  2. 2

    Enable REQ:IQ

    Open Content Setup → REQ:IQ - Viewer Requests and click Enable REQ:IQ.
  3. 3

    Watch it go live

    A small listener starts with fppd (about a 5-second loop). Your REQ:IQ viewer page now shows what's playing in real time, and requests are inserted right after the current song.

Changed your mind? Disable it from the same page — the listener stops and nothing phones home.

What leaves the box (and what doesn't)

The plugin sends exactly four things, all key-scoped, all HTTPS:

  • Your show key (to prove it's your show)
  • The list of .fseq filenames (for the calendar lock)
  • The box's hostname (for the "last pulled by" status line)
  • Playback status — current song, live/offline — but only while REQ:IQ is enabled

No media, no sequence data, no credentials. Your render of "Wizards in Winter" stays home.

Troubleshooting

"Couldn't reach SET:IQ or the key is invalid (HTTP 404)"

The key doesn't match any show — usually a typo, or the key was regenerated in SET:IQ. Copy a fresh key from Send to FPP and paste it again.

"Couldn't reach SET:IQ … (HTTP 0)"

The FPP box has no route to the internet. Check its DNS and gateway settings, or use the manual download path above.

Playlists imported, but FPP flags "Invalid mediaName"

The audio filename doesn't match the sequence name (we currently assume Song.fseq pairs with Song.mp3). Remap the media on that playlist entry in FPP. Exact media-name matching is on our roadmap.

The viewer page shows offline while the show is running

REQ:IQ is disabled, or the listener didn't start. Toggle it off and on from the REQ:IQ plugin page, and make sure fppd has restarted since you installed the plugin.

How do I update the plugin?

Content Setup → Plugin Manager → fpp-SETIQ → Update. It pulls the latest from the GitHub repo's main branch.
Stuck? Email support@lightsofelmridge.com — a real human reads it. Usually the same human who wrote these docs.