Pockitleformerly SurtitleLive
🖥️Pockitle Cue Station

Prepare and follow QLab cues

Select multiple subtitles, send them to QLab, and understand follow mode.

Prepare cues for QLab

Purpose: Create or update captions from a deployed show in a local QLab workspace for show control.

How to open this page: From the show card, open More ways to open and select Prepare cues for QLab. When available, the same page can also be opened from Live Console.

Before you begin: Install and open QLab 5, then save an editable workspace. Sync the show while online first. While the synced package remains valid, QLab preparation works offline without account sign-in or ASM unlock. Keep the show out of Live, including intermission. On first use, allow Pockitle Cue Station to control QLab in macOS System Settings → Privacy & Security → Automation.

QLab preparation with a workspace selector, cue placement status and a selected new cue (English interface, example data).
Choose the workspace and cues first. Placement does not prove playback or delivery to phones (English interface, example data).

Choose a workspace, format, and captions

  1. From Console, select Prepare cues for QLab. Choose the workspace under QLab workspace, then select Refresh to read QLab’s state.
  2. Expand Change to choose the primary, second, and third languages; whether to use the same or separate Stages; the Layer; whether character names appear; and whether stage directions are skipped.
  3. Search cue text or numbers under Search subtitles. Click each row to select or deselect cues one by one. You do not need Command or Shift.
  4. Shift-click is an optional range-selection shortcut. You can also press Space or Enter to toggle the focused row.
  5. Select all selects every cue in the current language, search, and filter results, not just the visible page. The list shows up to 200 rows per page; use Previous 200 and Next 200 to change pages.

Drag new cues, then check In QLab

  1. Read the footer, for example Drag 2 new. Start dragging from any selected new cue to the target Cue List in QLab. Pockitle Cue Station includes the whole current selection.
  2. Send to QLab…: Send to QLab is the standard action whenever the workspace, show, and selection are ready; it is not a fallback for drag-and-drop. For a mixed selection, Send to QLab inserts new cues after the cue selected in QLab (or at the end of an empty Cue List) and updates already placed cues in place. Drag-and-drop inserts only the selected new cues at the drop location; after the drop is verified, already placed selected cues are updated in place. Refresh and check each cue’s placement; placement does not mean playback, GO, or delivery to a phone.
  3. Return to Pockitle Cue Station and select Refresh. After QLab readback, check each row: Not placed means no cue was found; In QLab means it was identified in the selected workspace; Needs update means the workspace has older content.
  4. Select placed cues that need an update and choose Send to QLab…. Use Update all subtitles in QLab when appropriate. Updating changes identified cues; it is not a playback record.
  5. In QLab, check the Cue List, Stage, language, text, character, and cue count. Rehearse GO separately.

Selection, filters, and recovery

  • Dragging from any selected row drags the entire current selection, not just the row under the pointer. Before dragging, check the selected count and footer.
  • Changing search, language, Stage Directions filter, workspace, or show version clears the selection. Changing pages does not. Select all applies to all filtered results, not only the 200 rows on screen.
  • If a cue is still not placed, check the selected QLab workspace and destination, refresh the readback, then send the selected cue again when ready.

Prepared does not mean played

In QLab means Pockitle Cue Station read back the cue identity from the selected workspace. It does not mean QLab is playing, GO was triggered, or a phone received a caption.

QLab GO follow, permissions, and manual control

During an already-admitted local Live show, QLab GO continues advancing Mac projection through the authenticated local receiver during internet or Cloud control loss. Local follow needs the verified show, current cues, a connected receiver and QLab permission explicitly enabled and remembered for this show. Manual mode, Blackout, End, source changes or receiver loss pause local follow; network loss alone does not. Audience phones need internet and valid Cloud control ownership. Authorized reconnection publishes only the current cue, never GO history or an automatic takeover. Projector Settings, output adjustments, Blackout and End remain available while following.

  • QLab 5 needs a license that allows Script cues to drive phone captions. QLab Text cues for projection require the Video license. First-time use also requires macOS Automation permission. See the official Script Cues and Text Cues documentation.
  • Local follow checks the verified show, local ASM admission, remembered explicit QLab permission, current cues, authenticated receiver, local Live and Blackout. Phone synchronization is checked separately and does not gate local follow. This native interface has no Test or Arm button; use the displayed follow status and checks.
  • Select Switch to manual to pause local QLab cueing and phone publication. Use Follow QLab again when follow checks pass. If a cue is outdated during Live, continue manually. Go to Prepare cues for QLab opens the preparation page for inspection, but that page stays read-only throughout Live, including intermission. Prepare or update QLab cues after the performance has ended and rehearse before following again.

Expected result and audience impact: Prepare changes the selected QLab workspace. Verify native drag and drop by refreshing and reading back. GO may advance phones only when Receiver and phone sync status allow it. Placing a cue does not mean it played or reached a phone.

If something goes wrong: If no workspace appears, create and save one in QLab. For Automation denied, allow Pockitle Cue Station to control QLab and select Refresh. If status stays at checking or a generic failure, leave cues unplayed, return to Shows, and reopen the Prepare page. If it still fails, report the support code instead of repeatedly dragging cues.

Subtitle-text freshness is separate from QLab settings. Updating captions in Pockitle Cue Station does not write QLab cues automatically. Use the QLab preparation workflow to update changed text explicitly; ordinary text updates preserve cue names, notes, timing, fonts, colours, positions and routing. Replacing those settings requires the separate explicit replacement confirmation. Cue names, operator notes and unrelated cues are preserved even when App settings are explicitly replaced.

The same show’s stable cue IDs can still resolve after a verified subtitle revision. A removed cue ID is rejected rather than redirected by its old line number. Check QLab following and rehearse the affected cues after applying an update.

An ordinary text update stops if a QLab cue created by Pockitle Cue has custom group or wait timing. Inspect the conflict and restore Pockitle Cue timing before retrying. Replacing custom settings requires the separate explicit replacement confirmation; do not overwrite them just to clear an error.

Updating all placed subtitles also marks QLab groups for captions removed from the show; it does not delete those groups automatically. Review the marked groups and remove only cues confirmed unused, preserving other operator cues.