SET:IQ — Season Setlists & Templates

SET:IQ is a season planner. Instead of babysitting one playlist for 30 nights (your neighbors have ears), it builds setlists that are sized to your runtime, shaped like a real show, and aware of which songs are actually on your player.

One calendar for the whole season

Everything lives on a single season calendar. There’s no mode to pick and no switch to flip: by default a nightly auto-mix builds a fresh set for every show night, and you layer fixed templates — a weekend loop, a theme night, a one-off party — onto the days that repeat. Both live on the same calendar and both push to your box.

The header is a quiet strip: your show name, an ACTIVE badge (it’s a status light, not a button — the whole season is live and pushes to FPP & REQ), and the controls you reach for — Templates (with a count, like Templates (3)), Pull from FPP, Show settings, and Rebuild (which asks first, then keeps your pinned songs in place — see Keeping the season fresh).

Reading the calendar

The calendar fills the middle of the screen, with the Catalog rail on the left and the Inspector sliding in on the right when you open a night. Toggle Month or Season in the nav row:

• Month shows one month at a time, sized to fit without scrolling. Use ‹ › to page to any month — even months outside your season. Add a night in one of those and your season simply grows to include it.
• Season stacks every month of the run, trimmed to the weeks between your first and last night.

Each night cell is a quick read of the whole show day:

• Composition ribbon — a proportional bar in clock order: Pre-show → Show → Transitions → After hours, each segment as wide as the real time it takes. Hover it for a “Tonight · in play order” popover of the playlist as album art.
• Opener → closer art — the night’s first and last songs shown as artwork, joined by a dashed arrow, with an energy-arc sparkline and the quick metrics (songs · runtime · ±target).
• Occurrence bands — each fixed template running that day gets a slim colored band with its name and window. A one-off run carries a 📌. Two bands show at most; extras collapse into a +N more row. When a band sits above the Nightly Mix, the last one adds a + Nightly Mix ↓ hint so you know the auto-set runs after it.

Templates — fixed shows that run alongside

A template is a fixed show that runs on the days you choose — weekend loops, theme nights, one-off parties. It runs alongside the Nightly Mix, not instead of it. A template owns a whole show day: which days it runs (its recurrence), the clock window it plays in, the playlist, an optional pre-show and after-hours loop, and any triggers.

Want one big show that loops all season? That’s just a template that runs every day. Two templates that share a day in different windows is how you run a split night — a Family Hour 6–8 and a Late Night 10–11:30.

There are three ways to put a template on the calendar:

• Recurrence — in the template editor, tap the weekdays it runs (empty means every day) and set its date range. It paints every matching night automatically.
• Drag it onto a day — drag a template row from the Inspector’s list onto a calendar date to run it there once, as a one-off (that’s the 📌).
• The ⊕ day menu — open a day’s ⊕ and pick Run a template this day, New template on this date…, or (on a blank day) Add a night (Nightly Mix).

Theme-night quick-adds

When a tag in your catalog has enough songs to fill a whole night — say a dozen kids songs — SET:IQ offers it as a ready-made template. Tap a chip like Kids Night or Spooky Night and it seeds a new template named for the tag, fills the playlist from just those songs, and opens it so you can fine-tune. Tags that already have a template, and structural tags like opener or closer, never show up here.

The Inspector

Click a night, a template, or a warning and the Inspector slides in on the right. It’s docked and never modal — the calendar and Catalog rail stay live beside it, so you can keep dragging songs in while you work. Press Esc to close it. It has a handful of modes:

• Show night — one night, laid out in clock order.
• Nightly Mix — the auto-mix itself, as an editable template: its build settings, its own pre-show and after-hours, triggers, and PSAs that apply to every night. You can remove it here and restore it later (see the FAQ).
• Templates — the list of your fixed shows, with + New template.
• Template editor — edit one template’s recurrence, window, playlist, PSAs, and after-hours.
• Season fix plan — every open warning as a one-click suggestion (see below).

A night, in clock order

The Show night view walks the night top to bottom the way it actually plays: Pre-show → Show → Transition → After hours, with trigger “seams” between the phases. Each phase is a card you can edit in place, with a source chip that says where its content comes from — Show default, Nightly Mix template, or Edited tonight — and a ↺ to revert a night’s edit back to the default.

• Set this night’s window, its runtime target, whether it’s a tag night (All songs, or one tag only), and whether it’s a full show special night.
• Rebuild night deals a fresh set (pins stay); Remove this night takes it off the calendar.
• When more than one show stacks on a night, a Tonight strip of run pills — each template plus the Nightly Mix, in clock order — sits across the top. Click a pill to focus that run, tap ✎ to jump to its template, or ✕ to remove it from just tonight (the template itself is untouched). A dashed + runs another template tonight as a one-off, or starts a new one on this date.
• Songs show album art, a BPM band, and tags, with an Energy arc above. Drag rows to reorder, or use Rebuild to refill from your catalog. Every phase card collapses, so the drawer opens playlist-first with the Show already open.

Editing a template

Open a template and a violet Editing template banner marks that you’re editing the template itself — every night it runs. Set its Runs on days and window, its theme tag and accent color, build the Show list (drag, search, or ⚡ Quick build from your catalog), and add PSAs, transitions, and after-hours. You can slide a PSA to a new slot with its “after song N” box, unpin a one-off date from its date chip, and pause a template with the ⏸/▶ toggle — a paused template shows a PAUSED pill and stops painting nights until you resume it. + New template starts a fresh one and drops you straight into the full show day — pre-show, playlist, PSAs, triggers, transition, and after-hours are all editable before you save. Name it, pick its days and window, and choose a playlist type — a Fresh rotation that SET:IQ auto-builds at creation, or a Fixed playlist whose songs you pick yourself, in the same order every run.

A THEME & REQUESTS block on the template controls what viewers can ask for while it’s on the air. Take viewer requests during this run is on by default; turn it off for a hosted set and REQ:IQ closes requests for that part of the night — viewers see a “Tonight’s a hosted show” note and requests reopen on their own with the next run. When the template has a theme tag, Keep requests on theme (#tag only) limits the request list to that tag, with a live count of how many songs qualify (and a heads-up if fewer than five carry the tag, so the list won’t feel thin).

The Season fix plan

The calendar toolbar shows a warnings chip — “N warnings” or a calm “All clear.” Click it and the nights that need attention ring amber while the rest dim, and the Season fix plan docks in the Inspector. Every warning becomes a one-click suggestion.

• Tap Accept on a row and it flips to ✓ Applied. Accept all clears the whole list at once, and a toast lets you undo.
• Warnings are advice about the Nightly Mix — rotation balance, a song landing twice in a night, runtime versus target. A clean season reads “Nothing to fix — the season is clear.”
• A song that’s over- or under-used across the season gets a Quick Fix to rebalance it.

Keeping the season fresh

Add songs mid-season — usually by pulling from your box — and they land at the top of the Catalog rail in a green New — not in the mix yet section, each with a NEW pill. Tap Work them into the season and SET:IQ previews weaving each new song into the nights with the most runtime to spare, then applies it on your say-so. Two options ride along: Also add to template playlists and Rest over-used songs to make room (which trims only the fullest nights and always keeps your pins). Songs whose .fseq isn’t on the box yet are listed but sit out until you sync them.

The header Rebuild button now asks first, out loud. The Rebuild the season? dialog spells out its scope — how many nights are open, locked, or pinned, and which new songs will join — so a rebuild never quietly does nothing (it used to no-op on a fully-locked, FPP-imported season). An opt-in also rebuild FPP-imported nights unlocks and regenerates those too, and a toast afterward reports exactly what changed. Pinned songs and hand-edited nights are always kept.

Pre-show & after-hours

A pre-show loops before doors open; an after-hours loop keeps the display alive after the show closes so it doesn’t go dark. You set a show-wide default in Show settings → Before & after, and override it anywhere:

• Per template — a template’s Pre-show and After-hours each switch between Show default and This template (a custom sequence and timing) — handy when the kids’ template skips after-hours but the late one runs it until 11:30.
• Per night — in the Show night view, a Pre-show or After-hours card reading Edited tonight has overridden the default just for that date. The ↺ revert puts it back.

Triggers — commands during the show

A trigger fires something at a set moment. It can send an FPP command — turn the volume up at showtime, flip outputs on or off, run one of your saved command presets, or pick any command your box reports — or play a short sequence (a cue) from your catalog, like a chime or a station bumper. Add them to a template, or to a single night at the seams between phases (before the pre-show, at showtime, at a clock time mid-show, or after the show ends). A cue and a mid-show clock-time trigger both show up as a marker right in the night’s timeline.

1. 1

   Open a phase seam and add one

   Choose the command — Set volume, Outputs on/off, a command from your box, a saved preset, or a raw command with arguments.
2. 2

   Pick the box command from a live list

   The “command from my box” picker is filled from your FPP box’s own command list, so you only ever pick commands that actually exist.
3. 3

   Refresh after you add commands on the box

   Added a new command on FPP? Tap the refresh button next to the picker to pull the latest list — it shows how fresh the list is.

PSAs — drop in an announcement

A PSA is a non-song sequence you slot into the night — a station ID, a “tune your radio to 88.1” spot, a “thanks for visiting.” Open the PSAs section in a template or night, pick a sequence, and choose the song it plays after — or check Repeat on a cadence to fire it every N songs all night. It shows up on the show day and as a small 📢 on the calendar.

The host system — opener, closer & the bucket

Running a host on your matrix — someone who welcomes folks and gives the rules, pops back up with one-liners, then closes the night out? That’s Show Settings → HOST & PSAS, three pools:

1. 1

   Show opener

   Plays once per night, before everything (the FPP Lead In) — the welcome and the rules. It’s separate from your setlist opener, which starts every loop, so you can run both: host welcome once, then the setlist opener each pass.
2. 2

   PSA buckets — named piles with rules

   Make as many buckets as you need, each with a schedule rule. On call is the generic pile: it feeds the PSA frequency and any “Random from …” slots, using the whole pile before anything repeats. Guaranteed nightly plays one of its pile every night (a 3-deep pile covers 3 nights before repeating) — perfect for “one REQ:IQ explainer per night.” About once a week fires one pick on one random show night each week — the “Specter explains the show” special. Filling the generic pile is one click if you tag bits psa-random in the catalog (likewise psa-opener / psa-closer for the pools).
3. 3

   PSA frequency — a real setting

   The master cadence lives right below the buckets: “a PSA every N songs, from this bucket.” Templates inherit it; a template’s Customize or a night’s PSA frequency row (in the night drawer’s SHOW card) overrides it for that run or that night — settings → template → night, like everything else.
4. 4

   Show closer

   Plays once as the very last thing of the night (the FPP Lead Out, after the final loop finishes) — the goodnight.

Give an opener/closer pool several sequences and one is picked per night — in listed order or randomized. Theme and special nights can carry their own host spots: open the template, PSAS → Customize for this template. A PSA attached to a template directly stays out of the generic bucket unless you add it there too.

Structural songs stay out of the count

Openers, closers, transitions, after-hours, and PSAs are structural — they play by design, every night, so they sit outside your season’s “songs used” count. The coverage readout (covered / N songs) counts only the rotation — the songs the Nightly Mix draws from — so a closer that plays 30 nights never looks like it’s crowding out the rest of your catalog. Structural roles are set on the season and Show settings screens, not in a night’s rotation.

What “BPM-aware” actually means

When at least 60% of your catalog has real BPM values, SET:IQ shapes a set like a DJ would: opener → slow build → peak energy → wind-down → closer. Songs without BPM are treated as mid-tempo so the order stays stable. Below 60%, you still get great setlists — just without the tempo shaping. The Energy arc sparkline shows the shape.

Setting the show up

The first-run setup wizard is a guided, centered modal that opens over the dimmed calendar, with a step rail and a live summary strip (“Oct 1 – Oct 31 · 31 nights · shows 7–9p …”) that updates as you go. It won’t close by accident — Escape and clicking outside are off, so a stray tap can’t discard your setup. There are four screens:

1. 1

   Dates & hours

   Your season’s date range and your show hours. Weeknights and weekends each get their own start and end, so a Saturday can open later than a Tuesday. Want the show to follow the sky instead of a fixed clock? Switch the start to Sunset-based (see below).
2. 2

   Show length & feel

   Runtime targets, the energy arc, run bias, and repeat avoidance — with a live preview of the arc.
3. 3

   Show defaults

   The pools every night and template inherit, so you set them once: pre-show (a lead time before doors, or a fixed start time), transitions (how many per night, and whether to Randomize nightly or run In order across the season), and after-hours (how long it runs for, or a fixed end time). It’s optional — skip it and every night just inherits sensible defaults you can change later — there’s a real Skip for now button, and the progress rail honestly records “skipped.”
4. 4

   Starting layout

   Pick the layout to start from — Fresh every night (a new auto-built mix each night), One big show (one all-season playlist looping every night), Weekend & weeknight (two looping templates, each on its own nights), or Custom (nothing scheduled yet — start from an empty board and build the templates you have in mind first). Every season is templates underneath, so you can reshape it later either way.

Finish the wizard with Build my season — or Start building on the Custom layout, which opens the Templates panel so your first template is the next step.

After that, Show settings opens as one full-window scrolling page you read top to bottom — Dates & hours (with your Full-show nights), Show length & build, Show defaults, Song roles & weights, and Host & PSAs — while the rail on the left follows your scroll. The What you’ll get column on the right redraws your season live as you tinker, and carries the Manage templates and Re-run guided setup action buttons right above the save options. Changing anything ends with Apply & rebuild (keeps pinned songs and hand-edited nights) or Save without rebuilding if you don’t want tonight’s setlists touched.

Start at sunset

Under Dates & hours, the Show start control has two modes. Fixed time is the plain clock start you set yourself. Sunset-based lets the show follow the sky: enter your US ZIP code and pick an offset — 30 or 15 minutes before sunset, right at sunset, or 15 or 30 minutes after. SET:IQ looks up the local sunset for your ZIP and fills the start in for you, showing a plain-English line like “Sunset in Denver, CO on Oct 1 is 6:43p — your show starts 6:13p (30m before sunset).”

• It adjusts every night of the run, not just once — as real sunset creeps earlier through the season, your start time drifts with it, a minute or two at a time. The calendar times, the night drawer, and the FPP export all follow.
• A small sun chip sits by the calendar legend whenever sunset mode is on; its tooltip shows the offset and reminds you it auto-adjusts. A single night you set by hand still wins over the sunset time.
• Switch back to Fixed time any time and your start boxes come back exactly as they were.

Send it to your player

Pushing and pulling with your box lives in the FPP Hub — one place per show for connection status, your show key, and two-way sync. Full walkthrough: Connect FPP. Whatever’s on your calendar — the Nightly Mix and every fixed template — exports through one path, so your box always matches what you see.

• Fixed templates export as recurring schedule entries using FPP’s day codes (every day, weekdays, weekends, a single weekday, and more), so a recurring template is one tidy schedule entry — not one per date. A weekday combo FPP has no single code for (Wed + Sat, say) becomes one recurring entry per weekday — two rows, not one for every date all season.
• The Nightly Mix exports as one playlist and schedule row per date, exactly as it always has.
• Each template becomes a playlist named <Show> - <Template>, plus its pre-show, after-hours, and trigger entries.
• Running xSchedule? A native plugin pulls setlists the same way — see Connect xSchedule.

Pull a season in from FPP

Already built playlists and a schedule on the box? Pull from FPP reads them into your season — it re-dates the schedule to your season’s range and overwrites what’s on the calendar with what’s on the box, so SET:IQ becomes the single source of truth. It reads “runs forever” schedule rows and Lead In / Lead Out openers and closers, and overnight schedule entries stay pinned to the weekday they run, not spread across “every day.”

When your box pushes its playlists and schedule up on its own, a banner — “Your FPP pushed its playlists & schedule” — appears on the calendar with a Review & import button, so a push never looks like it did nothing. And when nothing can be placed, SET:IQ tells you exactly why — an outdated plugin sending names only, no catalog matches (with a couple of the box’s .fseq names to compare), or a schedule pointing at playlists the box never sent — instead of a silent empty calendar.

FAQ