Deck Builder

Presenter 1.2.6 and later: The workspace and keyboard behavior below, including K, stanza-pencil/E quick editing, expanded focus/add shortcuts and the pinned-open Properties default, applies from this version. These changes do not remove existing menu controls or saved pin choices.

Deck Builder is the service-order workspace. Sections organise the service; cues are the items Presenter shows or plays.

Know the three panes

Deck Builder with the Library, Deck and Properties panes highlighted
① Library · ② Deck · ③ Properties

  • Library on the left: reusable Media, Widgets, Lyrics, and Bibles.
  • Deck in the centre: sections and cue cards in presentation order.
  • Properties on the right: settings and subitems for the selected cue. While presenting, this area also contains Live View and live controls.

Resize the Library or Properties pane by dragging its divider. Double-click a divider to restore its default width. Properties is pinned open by default when no preference has been saved. Your saved pin choice is preserved. Select a cue to see its settings, and use the pin to keep the pane open or allow it to hide while stopped; its automatic hiding options are under Settings → Rendering & performance. Properties stays open while presenting so subitems and playback controls remain available.

Choose View → Layout to switch between Rows and Columns. With the deck canvas or a cue focused, press K without modifier keys to toggle between them. This works while stopped and while presenting; each mode remembers its own layout. Presenting uses Columns until you choose another layout while presenting. The shortcut is also shown in the View tooltip and beside Layout.

Presenter 2.0 and later: While presenting in Columns, cue cards hide the delete button; play and stop remain available. Stop presenting to delete a cue from its card.

Presenter 2.0 and later: Media and Widgets use two columns by default on this computer. Use the Two columns button beside the Library pin to switch to a list. Your saved choice is remembered; Lyrics and Bibles remain lists. In Focus mode, Media and Widgets always use two columns. Library and stopped Properties dim only while Focus mode is active. Turning Focus mode off restores them immediately. Adjust the idle delay under Settings → Rendering & performance → Library and Properties. Outside Focus mode, Widgets tiles show their names inside the card, while Media names stay below each picture. The columns button is not offered for Connect media, which remains a list. With the Lite profile (Settings → Rendering & performance), the Library is always a list with type icons.

Focus mode

Presenter 2.0 and later: Focus mode arrives with this update.

The moon button immediately left of the phone-remote QR icon in the title bar toggles Focus mode, remembered only on this computer. Library and Properties fade when idle; selecting or changing the deck, or clicking or typing in either pane, brightens both. Pointing or browsing alone brightens only that pane. Small secondary buttons (deck refresh/rename/settings/duplicate, history, view and column controls, and per-item Library actions) appear on hover or keyboard focus; touch screens, missing files and active imports keep item actions visible, and subscription locks stay visible. Media and Widgets use a two-column grid of pictures and icons; Lyrics and Bible remain lists. Section colours become quieter; the empty Suggestions strip tucks away. The live preview, Present button, cues and live controls never dim. Properties never dims while presenting. Turning Focus mode off restores your previous layout exactly. Picture names appear as captions inside Media/Widgets tiles on hover, keyboard focus or selection; tiles without a rendered picture keep a one-line name inside.

Deck Builder in Focus mode, with the moon button in the title bar highlighted
① Focus mode

Build a service order

Building a service order: Add Section, a Library item and the Properties of the selected cue
The numbers match the steps below.

  1. Use Add Section and give the section a clear service name.
  2. Choose a Library tab and drag an item into the section, or use the item's + to choose a destination. Opening the Library with a section's + lets you add several items directly to that section. A loose cue that is not inside a named section appears under General.
  3. Drag cues or complete sections to reorder them. The amber insertion line shows where the item will land.
  4. Select a cue to set its behavior in Properties, including advance mode, looping, linked translation, media fit, or cue-specific styling where supported. Presenter 2.0 and later: Properties starts with the cue’s name and type, then groups its settings under Content, Styling (including its Template), Playback and File; File stays closed until you open it.
  5. Review lyrics stanzas, Bible slides, and PDF pages under Subitems before going live.

A saved song’s stanza cards have a pencil in Properties → Subitems. Use it to open that exact stanza in Lyrics Designer, where its source text briefly highlights for quick editing. With a stanza focused in that pane, press E for the same action. In this flow, Escape returns to the deck even while stopped, after clearing search or dismissing an open panel and checking unsaved changes.

Deck changes are saved immediately. Use the toolbar or ⌘Z / Ctrl+Z for undo and Shift+⌘Z / Ctrl+Y for redo.

To empty a section, open its … menu, choose Remove all cues, then choose the same action again to confirm. The section and its settings stay in place. The action is unavailable for an empty section; Undo restores the removed cues.

Presenter 2.0 and later: Right-click a cue or a section header for its menu; a section’s … button opens the same menu. Menus start with Properties and Present, then editing and styling, then copy, paste and hide, and end with Delete. Delete asks again: choose it a second time to confirm.

Return to earlier work

Back / Forward in the title bar revisit earlier workspace locations, such as a selected cue, song, Library tab or folder. They leave live output unchanged. Use ⌘[ / ⌘] on macOS or Alt+Left / Alt+Right on Windows and Linux, or the back and forward buttons on your mouse, as in a web browser. Undo / Redo remains the way to reverse document edits.

The Time Machine clock opens saved deck and song history, which stays available after restarting Presenter:

  1. Choose a date. Materials shows content used that day; Changes shows recorded edits. Search stays on that date until you choose Search all dates.
  2. Select an entry to preview it without changing the current deck or live output. Changes → Saved versions… shows recoverable document versions.
  3. Use + on a historical cue to choose where to recover it. To drag an available material into the current deck, first choose Return to current; the history pane stays open.
  4. To replace the current document, stop presenting and choose Restore this version…, then confirm. Presenter saves the previous work as Before restore, including across later edits and restarts.

Time Machine starts recording when the feature is installed. It saves deck content and song text, but does not copy original image, video, audio or PDF files. Missing or replaced media cannot be recovered from this history; keep a local or online backup for those files.

Image and video drops

Dropping one image or video onto the middle of a compatible lyrics, Bible, audio, countdown, or QR-link cue sets it as that cue's background. Presenter shows a blue Set Background overlay before you drop.

Presenter 2.0 and later: Crossfade loop blends the end of a looping video into its start: it is on by default for cue backgrounds, the global background and default-slide videos, and off by default for regular video cues (enable Loop first). Crossfade duration defaults to 1 s and can be adjusted from 0.25 to 5 s in steps of 0.25 s.

To insert the file as a separate media cue, drop at the thin left or right edge of the cue, between cues, or in empty section space. Follow the preview shown during the drag; that preview is the action Presenter will perform.

How cues advance

CueLive behavior
LyricsOne parsed stanza or slide at a time.
BibleOne configured verse group at a time.
PDFOne page at a time.
ImageA single visual cue.
Video or audioTime-based playback with transport controls.
Website, YouTube, or SpotifyOnline playback or interaction; availability depends on the source and connection.
Countdown, QR, poll, quiz, or scoreboardBehavior configured in cue Properties; these live under Widgets.

Presenter 2.0 and later: A countdown can go live by itself. Turn on Goes live by itself in the countdown's Properties and set a Target time. Presenter starts the countdown at the target time minus its duration, so it ends at the target time, and Properties shows both times, for example “Goes live by itself at 18:59 · ends at 19:04”. Without a target time it stays manual.

Presenter 2.0.2 and later: When a video, audio or YouTube cue plays to its end, Presenter shows the default slide and waits. Press Space (or Next cue) to continue with the next cue. To move on by itself, turn on Go to the next cue when it ends under Playback in the cue's Properties. In a section that loops or is time based, the next cue always starts, so a pre-service loop keeps running. Looping videos never end. Before 2.0.2, a video inside a section always went straight to the next cue: check decks that rely on that.

Default slides

The deck default is the fallback slide. Choose it under View → Default slide, or right-click Library media and choose Use as deck default slide. A section's … → Default slide can follow the deck default, use its own media, or explicitly stay blank. Show default slide controls whether that slide appears between the section's cues. Removing a section override returns it to the deck default.

Presenter 2.0 and later: A Clock can be the default slide. Right-click a Clock you have styled and choose Use as deck default slide to make it the deck’s default slide, or open Default slide… and choose Clock. The default slide keeps its own copy of the Clock’s look, so restyling the original Clock or changing a design template later does not change it. Press D (or Default) to show it; it keeps ticking while it is on screen. Sections can still inherit it, use their own default slide or show a blank screen.

While presenting, click a default-slide marker between cues to show that section’s default slide immediately. While stopped, clicking the marker opens its settings. To change the settings while live, use the section’s … → Default slide menu.

This is different from Blank: Blank hides the current output until you unblank or advance.

Start at the intended place

  • The title-bar Present button starts on the selected section or cue after its two-step confirmation. With no selection, it falls back to the first enabled, non-empty section or the first loose cue.
  • To start on a particular stanza, Bible slide, or PDF page, select that subitem and press Space twice, or use its green play control twice.
  • Hidden cues and disabled sections cannot be started.

Design-mode shortcuts

Open Settings → Keyboard Shortcuts → Deck Builder (design mode) for the complete list.

  • Space: with focus in the deck or Properties, two-step start on the current selection, including the focused subitem. The first press arms confirmation; the second presents that exact stanza, slide or page. With an addable Library row focused, two presses add it to the selected deck section without presenting.
  • Enter: open Properties for the selected deck cue and focus its stanza, slide or page preview. Up/Down then previews the previous/next subitem without another click. Cues without subitems focus their settings instead.
  • Escape: return focus from the Properties preview to the selected deck cue, so arrow keys navigate the deck again. Text fields, search and open menus keep their own Escape behavior.
  • Tab: from a deck cue, Library row or Properties subitem, focus search in the current Library tab. In search, Tab cycles to the next Library tab and Shift+Tab to the previous one. Down enters the first visible result; Escape returns to search, clearing any query, then from empty search to the selected deck cue. The Library keeps its current tab and filters.
  • ⌘B / Ctrl+B: show or hide the Library.
  • ⌘Z / Ctrl+Z: undo.
  • Shift+⌘Z / Ctrl+Y: redo.
  • In Columns, Up/Down selects the previous/next visible cue in the section; Left/Right selects the previous/next section.
  • In Rows, Left/Right selects the previous/next visible cue in the section; Up/Down selects the previous/next section.

Click a cue to use these deck shortcuts. The selected card stays focused and visible. Moving to another section keeps the cue's position where possible, selects the nearest available cue in a shorter section, or selects the header of an empty section. Arrow navigation stops at the first or last cue or section. Click the Library to navigate its items with the arrow keys instead.

Entering the subitem preview keeps the currently inspected stanza, slide or page, or starts at the cue's configured start or first subitem. Previewing does not change the saved start position or start a presentation. These shortcuts apply while stopped; live presentation shortcuts keep their usual behavior.