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 always keeps your pinned songs in place).

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 show — 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, tagged with where its content comes from — Show default, Edited this night, or Template 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 changing the master — every night it runs. Set its Runs on days and window, build the Show list (drag, search, or ⚡ Quick build from your catalog), and add PSAs, transitions, and after-hours. + 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.

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.

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 Default for all nights and 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 this night has overridden the default just for that date. A revert link 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. It shows up on the show day and as a small 📢 on the calendar.

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, in-panel surface — a step rail with three screens, so nothing jumps around as you move through it:

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

   The vibe

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

   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, the Show settings drawer is one scrolling panel you work top to bottom: Dates & hours, The vibe, your before-and-after pools, and Manage templates. The deep-cut settings — Song roles (openers, closers, transitions), Song weights (play some songs more or less often), and Special nights (full-show nights with no target) — sit right there as collapsible cards, instead of behind a separate pop-up. Changing anything ends with Apply & rebuild, which keeps your pinned songs and any nights you edited by hand.

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