ace · agentic cue experience

v1.8.0

From the DMG on your desk to a working dashboard in five minutes.

1 · Quick start

Install ACE, watch the welcome screen, walk through the wizard, hit Start. ACE listens to the room and pushes the right slide automatically — without anyone clicking through cues during the keynote, the class, the show, or the service.

Install

1. Open the DMG you downloaded. Drag ACE into the Applications folder.
2. Eject the disk. Open ACE from your Applications folder (not from the DMG).
3. The first launch takes 10 to 30 seconds while ACE prepares the AI model.

The welcome moment

The first time you open ACE you'll see a brief animated welcome screen. Click anywhere to dismiss it, or wait 15 seconds and it'll move on by itself. If you prefer no motion at all, ACE honours your system's Reduce motion setting and shows a calm static version instead.

Five-step wizard

1. Welcome — what ACE does and how the rest of the wizard will play out.
2. Backend ready — ACE confirms its engine is up. If your Mac is new to ACE this can take half a minute.
3. Speech model — the AI model downloads in the background. The bar shows real progress: bytes, megabytes, estimated time.
4. macOS permissions — microphone and screen-recording access. Each step has an Open Settings button that jumps you straight to the right pane in System Settings.
5. Done — click Start using ACE and you're on the main dashboard.

If ACE detects a ProPresenter library on your Mac, the wizard offers the ProPresenter Migrator before handing off to the dashboard. See Section 4.

Activate the Bibles you need

v1.8 ships with nine Bible translations in the bundle. Two are pre-indexed and ready to use immediately — KJV (English) and RV1960 (Spanish). The rest (English ASV, BBE, WEB; Chinese, Arabic, Portuguese, French) need a one-click activation step.

1. Open Settings → Bible.
2. Find the translation you want.
3. Click Set up. ACE builds the search index in the background — usually 2 to 4 minutes per translation.

You can keep using ACE while builds run. The new translation joins live detection the moment its build finishes. See Section 8 for the full picture.

Start the service

1. Click Start in the top-left of the toolbar. ACE begins listening.
2. Speak, sing, or read something the system knows. If you've imported a song library, the lyrics auto-push to PROGRAM.
3. To send to a real audience screen, open Screen Configuration with ⌘+⇧+S.

ace · agentic cue experience

v1.8.0

A map of every panel and what it does.

2 · The dashboard

Toolbar — left side

• Start / Stop — turns AI listening on and off.
• Audio visualiser — traffic light for your microphone level. Amber and pulsing means too quiet; green means good; red means peaking. Click it to open Audio settings.
• Auto / Song / Bible — what ACE listens for. Auto picks the right kind contextually; Song-only locks to lyrics; Bible-only locks to scripture.
• Live / Hold — Live pushes detected matches to PROGRAM. Hold lets ACE keep listening without pushing anything (useful between songs).
• Confidence ± — tune the AI threshold live during the event.

Toolbar — centre (workflow modes)

Toolbar — right side

• Import — opens the unified wizard for songs, Bibles, slides and audio.
• ⚙ Settings — opens the Settings page.
• Audio visualiser — see toolbar-left.

Sidebar (left)

Your library: songs, presentations, Bibles. Drag items to reorder; the order becomes the day's Service Plan.

Centre column

• Show — current and next song-section cards, live transcript, scripture display, and the slide grid for the selected presentation.
• Edit — the slide-grid section editor (1 to 6 columns, click to expand, drag to reorder).
• Bible — verse-context view. Click any verse to open the full-chapter reader (Section 7).

Right panel

• Preview / Program — what's queued (Preview) and what's live (Program). This is where most operators drive the event from.
• Macros — buttons for common automations (clear all, switch look, blank).
• Sermon Notes — record talks or sermons with auto-detected scripture references.

Media Bin (bottom dock)

Playlists, the asset library, single-click trigger, fit modes, and the stock-content filter. Drag a media item onto the slide preview to make it the audience background.

ace · agentic cue experience

v1.8.0

3 · Bringing in your content

⌘+I or click Import in the toolbar. One wizard for everything you bring into ACE — songs, Bibles, slides, audio.

Six-stage wizard

What you can import

If your Mac doesn't have LibreOffice yet

ACE uses LibreOffice in the background to turn PowerPoint files into slide images. The first time you import a PowerPoint deck on a Mac without LibreOffice installed, ACE downloads and installs it for you (about 280 MB). Approve once and every future PowerPoint import uses the same install.

Starter hymn library

Settings → Data → Import → Install starter hymn library seeds your library with 12 well-known hymns so you can test detection straight away. Useful for first-time setup, demos, and quickly trying a new Mac.

ace · agentic cue experience

v1.8.0

4 · ProPresenter Migrator

A one-click on-ramp for teams moving from ProPresenter 6 or 7 to ACE. Auto-detects your install, scans the library, previews what will be imported, runs it, and tags the whole session so you can undo it later with a single click.

Where to find it

• If ACE detects a ProPresenter install on first launch, the onboarding wizard offers the migrator automatically.
• Any time after that, Settings → Import → Import from ProPresenter.

What it imports

• Songs — read from both .pro7 and the newer .pro filenames. Lyrics are cleaned from ProPresenter's internal formatting; duplicate slides that are really the same lyric in disguise are removed automatically.
• Section structure — Verse, Chorus, Bridge and so on are preserved (one ACE section per ProPresenter slide).
• Media — backgrounds, images, video clips. ACE de-duplicates by file content (two copies of the same image come across once).
• Playlists — imported with their original ordering.

Five-stage flow

Storage mode

• Symlink (default) — ACE links to your existing files. Fastest. Doesn't duplicate disk usage. Your ProPresenter library stays the source of truth on disk.
• Copy — ACE copies every file into its own folder. Use this if you plan to delete ProPresenter later, or if your ProPresenter library is on an external drive you might unplug.

ace · agentic cue experience

v1.8.0

5 · Themes and Looks

ACE separates how things look (Theme — fonts, colours, background) from what's enabled (Look — which layers render on which screens).

Themes

A theme defines: font family, size, weight and colour; subtitle colour; background mode (solid, gradient, or image); text shadow; position; margins; line-reveal speed.

• Click Theme in the toolbar.
• Grid view shows your themes. Click a tile to open the editor. Hover the play button to apply a theme to PROGRAM without editing. Hover ✕ to delete.
• + New Theme creates a custom one from a template.

Looks

A Look is a named bundle of:

• Which layers render (slide, media, messages, announcements, bible, props).
• Which theme each output uses (different theme per screen if you want).
• Per-screen layer overrides (one screen shows media, another doesn't).
• Transition duration.

Click Looks in the toolbar. The per-Look grid lets you toggle layers per output and pick the theme each output should use. Click Make Live to activate a Look — PROGRAM repaints within about a second.

Unified render pipeline

Settings → Screens & Display → Advanced → Unified render pipeline.

• On — the active Look drives every output. Edit a Look and audience screens repaint in real time. Per-screen overrides apply.
• Off — older behaviour where one global theme drives all outputs. Looks save but don't take effect.

Once you've used the Unified render pipeline for one full event, leave it on. A future release flips this default.

ace · agentic cue experience

v1.8.0

6 · Outputs (Screen Configuration)

⌘+⇧+S opens Screen Configuration — the single source of truth for what your audience and your operator team see.

Audience vs Stage

• Audience — what the room sees. Lyrics, backgrounds, scripture. Edge-to-edge.
• Stage — what the worship team, lecturer, preacher, or actors see. Confidence layout (current and next slide, timer, clock, sermon notes).

Multi-display

Both roles can drive multiple displays — for example seven audience screens plus three stage screens at once if your rig has the displays.

Display Mode (per output)

• Borderless Fill (default) — fills the display without taking over Mission Control. Multi-display friendly.
• True Fullscreen — own Mission Control Space, smoother for single-output venues. Swipe with a four-finger trackpad to reach the operator UI.

State badges

Screens menu (macOS menu bar)

• Configure Screens ⌘+⇧+S.
• Identify All Displays — flashes DISPLAY N on every connected display.
• Test Pattern — Color Bars, Focus, Greyscale, Solid.
• Clear All Overlays Esc.

ace · agentic cue experience

v1.8.0

7 · Detection — lyrics and Bible

ACE listens to your room with on-device AI and matches what it hears against your library — songs and scripture both. About 200 milliseconds from sound in the room to slide on the screen.

Modes

• Auto — detects either lyrics or Bible references and switches contextually.
• Song — locks to lyric matching. Best during worship sets and song-led events.
• Bible — locks to scripture references. Best during sermons, lectures and any talk that quotes scripture often.

Switching modes automatically clears stale detection state. No need to stop and restart.

Multilingual detection

Settings → Audio → Language controls what ACE expects to hear:

• Auto-detect (bilingual / multilingual) — default for code-switching congregations. ACE detects the spoken language per utterance. Useful when the preacher or speaker moves between two or more languages mid-sentence.
• Single-language — lock to one language for cleaner transcription if your event is in one language only.

v1.8 adds support for 25+ languages including English, Spanish, Portuguese, French, German, Italian, Chinese, Arabic, Hindi, Indonesian, Japanese, Korean, Malay, Tamil, Telugu, Tagalog, Turkish, Amharic, Hausa, Igbo, Swahili, Xhosa, Yoruba and Zulu.

What detection actually searches:

• Songs — every song in your library, regardless of language.
• Bibles — only enabled translations with a built search index. Out of the box that's KJV (English) and RV1960 (Spanish). Activate more from Settings → Bible. See Section 8 for the full picture.

Mid-session pipeline switch

v1.7.5 added the ability to switch between offline (Whisper) and online (Deepgram) transcription mid-event without stopping detection. Open Settings → Detection → Transcription Pipeline Mode, flip the toggle, and ACE rebinds to the new pipeline against the in-flight audio stream.

When to flip:

• Offline (Whisper) — default. No internet needed. Works everywhere.
• Online (Deepgram) — when room conditions are tough (heavy accents, noisy environments, complex polyphonic worship audio) and you're confident your internet is solid.

Auto-ACR fallback for worship audio

When ACE is in Auto or Song mode and Whisper-offline produces only hallucinations for three buffers in a row on unconfirmed audio, ACE automatically tries audio-fingerprint identification (the same path as the manual Re-ID button) and pulls lyrics through Genius. No operator action needed. Bible mode has no fingerprint fallback, so this only kicks in for songs.

Sermon recording

Bottom-right of the dashboard there's a Sermon Notes panel.

1. Optional — fill in title and speaker.
2. Start Recording — ACE captures the full transcript, extracts key points and auto-detects Bible references as the talk unfolds.
3. Stop Recording — the Export button appears. Export contains full transcript, key points and scripture, with the live snippet that triggered each scripture match shown beneath the canonical verse.
4. Past recordings live under Settings → Data → Sermon History.

Smart Bible auto-advance

When a verse is on screen, ACE listens for the next verse's text in the live transcript. If the speaker reads verse N+1 directly without saying "next verse," ACE advances on its own. The slide tracks the speaker — nobody clicks.

Bible chapter reader · click any verse

Click any detected verse in PROGRAM, PREVIEW, the Bible-suggestions strip, or the BIBLE DETECTED card and the full chapter opens in a modal. The active verse is highlighted in gold and auto-scrolled to the middle. Every other verse in the chapter is rendered for context.

• Hover a verse — a Push button appears. Click it to pivot to that verse without closing the modal.
• Esc — close.
• PageDown / PageUp — advance or retreat one verse (also works without the modal open).

Verse lock

⌘+⇧+L toggles a lock on the currently-displayed Bible verse. While locked, ACE keeps listening and shows possible matches in the transcript feed, but nothing auto-pushes to the audience screen. You can still advance or retreat manually with PageUp / PageDown. Press ⌘+⇧+L again to unlock.

Use this when ACE has found the right verse and the speaker is going to sit on it for a while.

Detection Reset

⌘+⇧+R clears stuck votes, transcript history, and the AI's listening context — without stopping the microphone. The right move if a detection has drifted onto the wrong song or verse and won't recover.

ace · agentic cue experience

v1.8.0

8 · Bibles and translation packs

v1.8 bundles nine public-domain Bible translations and turns each one into an independent translation pack you can switch on or off without affecting any other. The result: a far smaller installer and a clean, operator-facing way to choose what ACE searches.

What's in the bundle

Nine public-domain translations across six languages ship with v1.8:

Two translations — KJV and RV1960 — arrive with their search index pre-built so detection works the moment you launch ACE. The other seven ship as text only; click Set up once and ACE builds the index in the background.

The Bible Translations panel

Settings → Bible → Bible Translations. Translations are grouped by language. Each row has a status badge:

• Ready — indexed and live in detection. Searches happen across this translation.
• Needs setup — text shipped; click Set up to build the search index. Two to four minutes per translation depending on your Mac.
• Preparing… — build in progress. Shows a percentage bar with a message ("Embedding verses…", "Writing index…").
• Coming later — in the roadmap, awaiting written redistribution clearance from the rights holder. See the next section.
• Disabled — operator switched it off. Index is preserved; click Enable to bring it back into the search.

Building a translation

1. Open Settings → Bible.
2. Find the translation you want.
3. Click Set up.
4. ACE builds the index in the background. You can keep using the app — already-built translations stay searchable the whole time.
5. When the build finishes the badge flips to Ready. The translation joins live detection immediately.

Coming-later languages

Yoruba, Igbo, Hausa and Swahili appear in the panel as Coming later. They're in the roadmap but blocked on written redistribution clearance from the Bible Society and other rights holders. No text data ships for these yet. The moment a translation clears, it ships in a free patch update and existing installs pick it up on the next auto-update check.

This is a deliberate choice over shipping unlicensed material. When the licences land we'll announce it on the marketing site and through the mailing list.

Per-row expand · licence info

Click the ▾ on any row to see the licence, copyright holder, the source the text came from, whether the pack is bundled in the installer, and a Remove search index link if you want to reclaim disk space without uninstalling the text.

Auto-detect translation vs preferred translations

Above the translation grid there's an Auto-detect Translation toggle:

• On (default) — ACE picks the right translation for each utterance automatically, based on what's enabled.
• Off — a Preferred Translations grid appears. Toggle pips per translation to pick the ones ACE should rely on first. Useful for events that stick to one translation throughout.

Importing your own Bible

If you have a Bible in a format ACE supports (MyBible .SQLite3, OSIS XML, Zefania XML, OpenSong XML), use Open Import Wizard from the Bible panel. After import, the translation appears in a Custom group at the bottom of the panel — clearly distinct from the bundled translations — and runs through the same status lifecycle.

ace · agentic cue experience

v1.8.0

9 · Stage layouts

The operator's confidence monitor is fully designable. Open the Stage tab in the toolbar.

Pick a preset (current-next, current-notes, current-timers, system-clock, blank) or create a new layout.

Object types

• Text — static labels.
• Live text — a piece of text that updates: current slide, next slide, system clock, timer, presentation name, stage message, video countdown.
• Shape, image, media placeholder.

Each object has a position and size on a 1920×1080 canvas. Style picker lets you choose a semantic colour token (primary, secondary, next, timer, clock, muted) so the colour follows the active theme, or set a custom hex.

Mirror Program

Each stage layout has a Mirror Program checkbox. When on, the stage screen mirrors whatever's on the audience output (slide image, scripture, song background, video) as a full-bleed backdrop — with your text objects (current/next lyric, clock, timer, stage message) on top. Speakers, lecturers, preachers and actors see exactly what the audience sees, plus their cues, without turning around.

ace · agentic cue experience

v1.8.0

10 · Service Plan & Quick Screens

The day's order, in one place; and a fast way to push ad-hoc screens between items.

Service Plan

Drag songs, scripture, prayer, sermon, announcements and media into a vertical timeline. Press Go On Air to advance through the items.

• The first time you click + Add Item, ACE creates a plan called "Untitled Service" with today's date. You can rename it and re-date it any time.
• Each item has its own theme, layer configuration, timer and auto-advance rules.
• Planning Center Online sync is available if your church already uses Planning Center.

Multi-day plans

v1.7 added day tabs on top of the setlist. The same Service Plan can hold many days side by side — Friday rehearsal, Saturday set, Sunday morning, Sunday evening. Click a day tab to switch. New items belong to whichever day is active when you add them, and Go On Air only walks the active day. Useful for conference weeks and multi-service weekends.

Quick Screens · ⌘+J

A floating panel at the bottom-right of the dashboard. Type a message, pick a theme, push to PROGRAM in one click.

• ⌘+J toggles open or closed (skipped while you're typing inside an input or textarea).
• ⌘+↵ displays the typed message.
• Your last 10 entries live on a Recent shelf for one-click reuse.
• Use cases — announcements, prayer calls, offering reminders, lower-thirds between scenes.

ace · agentic cue experience

v1.8.0

11 · Settings

⌘+, or click ⚙ in the toolbar. The sidebar groups every setting under a high-level category.

General

• App — app name, theme (light or dark — currently dark), language.
• Updates — current version, latest release, and the notes that came with it.
• Audio — input device, sample rate, gain, plus Recovery (re-download the speech model, re-run the setup wizard).
• Network — backend port and allowed origins.
• CCLI — your church CCLI licence number. ACE shows it on slide footers and includes it in exports.
• Display Hold — how long strong-confidence matches stay on screen, and how long weak matches stay.
• Tour — re-trigger the in-app tour.

Detection

• Detection mode — Auto, Song-only, Bible-only.
• Confidence threshold — global AI confidence floor (live-tweakable from the toolbar).
• Voice-activity detection bypass — how loud quiet audio has to be before ACE still runs transcription on it. Lower catches whispered audio; higher ignores background noise.
• Bible parser — strict or lenient matching; how many verses of context to show.
• Voice control — voice commands like "ACE next slide".
• Speech model — pick the size that balances accuracy and memory for your Mac.
• Transcription language — Auto-detect (handles code-switching), or pick a specific one. 25+ languages supported in v1.8.
• Transcription pipeline mode — Offline (Whisper) or Online (Deepgram). Mid-session switchable.
• Auto-display Bible — whether Bible detection auto-pushes to PROGRAM.

Bible

• Bible Translations panel — per-translation status, Set up / Enable / Disable buttons, licence info on expand. See Section 8.
• Open Import Wizard — for user-supplied Bibles in MyBible / OSIS / Zefania / OpenSong XML formats.
• Auto-detect Translation — on by default; turn off to manually pick preferred translations per language.
• Preferred Translations grid (when auto-detect is off) — per-language groups with on / off pips per translation.

Output

• Screens & Display — Configure Screens, per-output assignment, role, display mode.
• Theme background and typography.
• Unified render pipeline — see Section 5.
• NDI output — toggle, source name, channel.
• MIDI — incoming MIDI shortcut bindings.

Data

• Song Index — re-index, drop & rebuild, view index size.
• Import — default conflict-resolution mode, default theme, Import from ProPresenter, Install starter hymn library.
• PowerPoint rendering — DPI and rendering backend.
• LibreOffice — install, re-install, view status.

ace · agentic cue experience

v1.8.0

12 · Keyboard shortcuts

Every shortcut in ACE, grouped by what it does. Per-shortcut customisation is on the roadmap; today every shortcut listed here works as shown.

Clear layers

Slide playback

Screen outputs

Navigation

Toolbar modes

Detection

macOS menu (always works)

Quick Screens (when panel is open)

Bible chapter reader (when modal is open)

ace · agentic cue experience

v1.8.0

13 · Common workflows

Sunday-morning worship service

1. Open ACE 30 minutes before service.
2. Service Plan tab — drag today's songs in order (or sync from Planning Center).
3. ⌘+⇧+S — confirm Audience and Stage toggles are on, displays assigned, both Live.
4. Pick the Look that matches the service mood.
5. Start detection. Walk to the booth, hand over to the operator.
6. During worship — ACE auto-advances through detected songs. Press F1 between songs to clear, or just let the Display Hold expire.
7. Sermon — switch to Bible mode (⌃+B) or stay on Auto. Sermon Notes start recording. Scripture detected and pushed automatically. If the preacher settles on one verse, lock it with ⌘+⇧+L.
8. After service — stop detection, export the sermon for archiving.

Bilingual / code-switching service

1. Settings → Audio → Language — set to Auto-detect (bilingual / multilingual).
2. Settings → Bible — make sure both languages' translations are Ready. For an English + Spanish service: KJV and RV1960 are both ready out of the box. For English + Chinese: click Set up on CUV the day before so it's ready by Sunday.
3. Run the service exactly as you would a single-language one. ACE handles the switching.

Conference keynote / mid-week event

1. Import the speaker's deck via the wizard.
2. Bible references in slide titles and notes are auto-tagged.
3. During the talk — slides advance automatically as the speaker progresses.

Multi-day conference week

1. Open Service Plan. Use the day tabs to lay out Friday, Saturday morning, Saturday evening, Sunday — each as its own tab.
2. Add items to whichever day is active when you add them.
3. On the day, click that day's tab and press Go On Air.

Classroom lecture

1. Import the lecture deck.
2. Use Auto detection — citations, scripture references and section heads auto-push as the lecturer hits them.
3. Open Quick Screens (⌘+J) for ad-hoc announcements.

Theater & live show

1. Pre-load the cue order in Service Plan.
2. Use Quick Screens for ad-hoc announcements between scenes.
3. Lower-third overlays go through the props layer in the Media Bin.

Migrating from ProPresenter

1. Install ACE. On first launch the wizard offers the migrator if it spots a ProPresenter install. Accept.
2. Preview what's coming across. The counts should look right.
3. Pick Symlink for the first import. Your ProPresenter library stays in place.
4. Run the import. Walk through your library inside ACE and confirm everything's there.
5. Run a rehearsal. If anything's wrong, open the migrator again and click Undo.
6. When you're ready to retire ProPresenter, run the migrator again with Copy so your files live inside ACE.

ace · agentic cue experience

v1.8.0

14 · Troubleshooting

"I installed v1.8 but Chinese / Arabic / Portuguese / French detection doesn't work"

By design. v1.8 ships those translations as text only. The search index is pre-built only for KJV (English) and RV1960 (Spanish), to keep the installer small. Open Settings → Bible, find the translation, and click Set up. The index builds in the background — typically two to four minutes. Detection picks the translation up the moment the build finishes.

"Yoruba / Igbo / Hausa / Swahili shows as 'Coming later' — when will they ship?"

These translations are in the roadmap but blocked on written redistribution clearance from the rights holders. The licensing conversations are in progress. The moment a translation clears, it ships in a free patch update and your install picks it up on the next auto-update check. Sign up to the mailing list at ace-presenter.app for the announcement.

"Detection is searching the wrong translation"

v1.8 detection searches every enabled translation that has a built index. To narrow it down:

• Settings → Bible → Bible Translations — click Disable on the translations you don't want, or
• ⌘+⇧+L while a verse from your preferred translation is on screen — locks it. Alternatives still surface as suggestions but won't auto-push.

"First launch hung for ages on v1.7"

Fixed in v1.8. The old Bible loader did a per-verse duplicate check that scaled badly with many translations. v1.8 hoists that into a single bulk query — a clean install with all bundled translations active completes in under a minute. If you're upgrading from v1.7, your existing data is preserved.

"Auto-updater stuck on an old version"

Check Settings → General → Updates to see your current version and what's available. If the auto-updater hasn't picked up the new release, force-quit and relaunch — ACE polls every 24 hours on cold start. You can also download the DMG directly from ace-presenter.app.

"I imported a Bible but I can't see it in the panel"

Fixed in v1.6.1 and confirmed in v1.8. Update to the latest version and your imported translation will appear in the Bible panel's translation list and in Settings → Bible, in a Custom group below the bundled translations.

"ACE won't launch on my Intel Mac"

Fixed in v1.6.0. Earlier versions had an issue specifically with Intel Macs (the wrong helper binary was bundled). Download the latest version from ace-presenter.app and reinstall.

"My microphone level is low" (visualiser is amber)

• Check the input device in Settings → General → Audio.
• If you're using an external interface, confirm the room mic is routed to ACE's input.
• Move closer to the mic source if you can.

"Detection isn't picking up my song"

• Confirm the song is in your library — Settings → Data → Song Index.
• Try Manual Search (⌘+F) — this confirms ACE has indexed the lyrics.
• If the song is genuinely obscure, ACE can fall back to audio fingerprinting on the cloud-fallback path (Section 7).

"My slide isn't reaching the audience screen"

• Confirm Audience output is Live (green badge in ⌘+⇧+S).
• If the active Look has the media layer disabled per-screen, slides hide. Open the Looks panel to check.

"Detection is hallucinating or pushing the wrong verse"

• Press ⌘+⇧+R. This clears stuck votes, transcript history, and the AI's listening context without stopping your microphone.
• If it keeps happening on a specific verse, lock the verse with ⌘+⇧+L and advance manually.

"PowerPoint imports as plain text on black, no slide design"

• This is a LibreOffice background-conversion issue. ACE re-runs the conversion in a fresh workspace every time, which fixes the most common cause. If it still happens, contact support — ACE captures the failure detail in the log so we can help quickly.

"I cleared a slide but the image is still on the audience screen"

Fixed in v1.5.4 and later. F2 now clears the lyric overlay and the slide image as one cue. Update to the latest version.

"After I plug into a single external display, my dock disappears"

Fixed in v1.5.7 and later. On single-display setups, ACE keeps your dock visible.

"Old slide keeps showing after I deleted the PowerPoint"

Fixed in v1.5.3 and later. Delete now also clears the audience screen if it was showing one of the removed slides.

"Onboarding wizard's Open Settings button does nothing"

Fixed in v1.5.5 and later. The wizard now correctly jumps you to the right pane in macOS System Settings for microphone and screen-recording permissions.

"My ProPresenter migration imported the wrong items"

Open the ProPresenter Migrator again (Settings → Import). Find the session in the history. Click Undo. Run the migrator again from scratch.

ace · agentic cue experience

v1.8.0

15 · Your data

ACE keeps everything on your Mac. Nothing important is in the cloud unless you explicitly turn on a cloud feature.

Where it lives

• Your imported songs, Bibles and presentations live in an ACE data folder inside your Mac's user library.
• Each Bible translation has its own search index file inside that folder (one file per translation, so adding or removing a translation doesn't affect any other).
• Your operator preferences live in a single configuration file in the same folder.
• Backend and main logs live in a separate Logs folder in your user library.
• LibreOffice, when installed via ACE's deferred-install, lives inside the same ACE data folder.

Upgrading from older versions

If you're upgrading from v1.7 or earlier, the old monolithic Bible index is archived to a backup folder inside your ACE data folder on first launch of v1.8. Your songs, presentations, themes, Looks and stage layouts are preserved.

Resetting ACE

1. Re-run setup wizard only — Settings → Audio → Recovery → Re-run setup wizard. Clears wizard flags, keeps everything else.
2. Full factory reset — quit ACE, delete the ACE data folder in your user library, relaunch. The first-run wizard fires again from scratch.

16 · Getting help

• In-app tour — Settings → General → Show tour again.
• Release notes — Settings → General → Updates shows what changed in your version.
• Email support — hello@ace-presenter.app.
• Marketing site — ace-presenter.app.

17 · Glossary

18 · Feature index

Every distinct surface in the app. Use it as a discovery aid; the narrative is in earlier sections.

Toolbar (top of dashboard)

Centre column

Right panel

• Preview / Program — what's queued and what's live.
• Macros — operator-fired automation buttons.
• Sermon Notes — title, speaker, Start / Stop Recording.

Media Bin (bottom dock)

• Playlists, asset library, stock-content filter, fit modes, drag onto preview.

Output windows

• Audience window — renders PROGRAM theme + slide / scripture / lyrics overlays.
• Stage window — renders the active stage layout. Mirror Program shows a full-bleed audience backdrop with stage cues on top.
• Multi-view — live preview of every output in one window. Read-only.

Floating surfaces

• Quick Screens (⌘+J).
• Command Palette (⌘+K) — fuzzy-search action launcher.
• Bible chapter reader — click any detected verse to open the full chapter.
• In-app tour — re-trigger from Settings → General.
• Onboarding wizard — Welcome → Backend → Model → Permissions → Done.
• Animated welcome splash — first-launch brand intro. Honours your system's Reduce-motion setting.

Migrator and library tools

• ProPresenter Migrator — one-click import from ProPresenter 6 or 7.
• Install starter hymn library — seeds 12 well-known hymns for instant testing.
• Bible Translations panel — per-translation lifecycle, status badges, Set up / Enable / Disable.