Troubleshooting Live
Five failures cover nearly everything that goes wrong on a Sunday. Each has a diagnosis question and a fix under two minutes. Panic is optional; skip it.
🎯 By the end you'll be able to
Diagnose which of the five classic failures you're looking at, apply its fix without leaving your seat, and keep the room calm while you do it.
DOCTRINEThe three rules of live failure
- Blank beats broken. If the screen is showing something wrong, press Esc first. A clean background for thirty seconds is invisible; a glitching screen is a spectacle.
- Diagnose by layer. Lesson 1.4's chain: cable → macOS → FreeShow → style. Ask "which link?" before touching anything.
- The service continues. The band can sing a verse without lyrics; the pastor can read from the Bible in their hand. Nothing on this page is an emergency — work the problem, don't perform it.
FAILURE 1Output on the wrong display
Symptom: FreeShow's output fills your control screen; the projector shows the desktop or nothing.
Fix (docs-verified):
- Settings (gear) → Outputs → Window → "Choose screen" → pick the projector.
- Window completely lost (on a display that no longer exists)? "Change output screen values" — set X/Y manually to drag it back into reality.
FAILURE 2No output at all
Symptom: Projector shows the style background (or black); clicking slides changes nothing anywhere.
Diagnose in this order:
- Is Present on? Look top right — the button must be red. If not: ⌘O.
- Was the output window double-clicked? That disables it (documented behavior — Lesson 1.4). Re-enable via the Present button.
- Is the output locked? If slides won't change but the screen shows old content: ⌘L may have been toggled. Press it again.
- Still stale? ⌘R updates/re-sends the output.
FAILURE 3Your desktop on the projector
Symptom: The congregation sees your Dock, your files, this course.
Fix: That's macOS mirroring, not FreeShow. System Settings → Displays → set the projector to extended. Then confirm FreeShow's output still targets the projector (Failure 1's steps). Press Esc/⌘O to give the room a clean screen while you do it.
FAILURE 4Text overflows the screen
Symptom: A verse runs off the bottom, or bilingual text is microscopic.
Live fix: usually none needed for one slide — keep going, fix after the service. If it's every slide (wrong style active), switch the style (Lesson 2.4).
After-service fixes, in order of correctness:
- Split the content: blank lines in the lyrics (Lesson 3.3) or fewer verses per slide for scripture (Lesson 3.2).
- The style's line limit: styles can cap lines shown at once (documented — e.g. max 2 lines); a limit too generous for the font size shows as overflow.
- The template — if a template's text box is the problem, fix it once there and every show inherits the fix. Hand-formatting single slides remains the wrong answer.
FAILURE 5The app freezes
Symptom: Beachball; clicks do nothing for 15+ seconds.
- Wait one full breath — heavy video sometimes stalls briefly and recovers.
- Still stuck? Quit and reopen: ⌘Q; if truly frozen, Force Quit (⌥⌘Esc → FreeShow). Your content is safe — shows and settings live on disk in
~/Documents/FreeShow. - Reopen FreeShow → ⌘O → reopen today's project → click the slide you were on. Practiced once, this whole cycle is under a minute.
- Meanwhile the room sees a dark projector — which looks like an intentional blank. Rule 1 working for you.
Do a deliberate quit-and-recover during practice. Operators who've done it once treat it as a procedure; operators who haven't treat it as a catastrophe.
PLAYOne service, all five failures
Now sit at the desk. It is mid-service, the room is full, and the five failures above reach the hall screen one after another. Read the hall screen, then your own screen, and choose a move. Every move takes time, and the room keeps looking at whatever is up there while you work. The seconds on the cards are round numbers for the game; the 30 seconds a blank screen goes unnoticed is rule 1. Play the service twice.
Notice what the score rewarded. With your desktop on the hall screen, the same 20-second fix cost 20 seconds without Esc and 2 with it: that is blank beats broken. Where the screen was already blank you had that cover without pressing anything, so there was time to ask which link broke. Both screens showing the same picture is macOS mirroring. A dark hall with the slide filling your Mac is FreeShow’s output on the wrong display. A calm background with clicks that do nothing is Present switched off.
Two failures did not fit the reflex. A line off the bottom of one slide was nothing urgent, and the right move was to carry on, because the service continues. And a frozen app cannot hear Esc: quitting it is what blanks the screen, which is rule 1 working for you.
TRY IT NOWBreak it on purpose
1. Present a hymn, then double-click the output window — watch it die (Failure 2, cause 2). Recover with the Present button. 2. Lock with ⌘L, try changing slides, unlock. 3. Quit FreeShow mid-slide and run the full recovery: reopen → ⌘O → project → slide. Time it. 4. Say out loud, from memory, the fix for the desktop-on-projector failure.
RECAPThe five, on one card
- Wrong display → Settings → Outputs → "Choose screen" (or "Change output screen values").
- No output → Present red? Output window double-clicked? ⌘L locked? Then ⌘R.
- Desktop visible → macOS mirroring; set the projector to extended.
- Text overflow → keep going; fix later by splitting content, then style line limits/template — never per-slide formatting.
- Frozen app → quit (or Force Quit) → reopen → ⌘O → project → slide. Data is safe on disk.
- Above all: Esc first, diagnose by layer, the service continues.
ACTIVE RECALLCheck your understanding
Answer in your own words first, then reveal.
1Screen went dark right after you adjusted the output window's position. Most likely cause?›
You double-clicked the output window — which disables it. Re-enable with the Present button (⌘O).
2Why is a frozen FreeShow not a data emergency?›
Shows and settings live on disk in ~/Documents/FreeShow — a restart reloads them. The recovery is reopen → ⌘O → project → slide.
3One hymn slide overflows mid-worship. What do you do now, and what do you do at 1 PM?›
Now: nothing — keep the service moving (blank it with Esc if it's unreadable). At 1 PM: split the slide with a blank line in the lyrics, or fix the style/template if it affects many slides.