Backups & Updates
Everything the churches rely on — songs, Bibles, templates, styles — is files on this disk. Ten minutes a month keeps it unbreakable.
🎯 By the end you'll be able to
Take a full backup, know exactly what's in the data folder, restore from a backup, and update FreeShow without endangering a Sunday.
GEOGRAPHYWhere everything lives
Per the official docs, FreeShow stores its data in the Documents folder by default — on this Mac: ~/Documents/FreeShow. The residents you care about:
| Folder | Contains |
|---|---|
Shows/ | Every show — the 18 hymns, welcome/announcement decks — as .show files |
Bibles/ | The offline Bibles (WEB, KJV, 개역한글) |
Backups/ | Archives created by "Backup everything" (docs-verified) |
Exports/ | Exports, including the CCLI usage logs (Lesson 3.4) |
_backup-2026-08-20/ | The known-good config backup from the day this system was set up |
Folder locations are configurable in Settings → Files (docs-verified) — but on this Mac they're already right; you'll never need to change them.
STEP BY STEPTaking a backup
- In FreeShow's settings, run "Backup everything." Per the docs it writes an archive into the
Backupsfolder — shows, projects, settings, the lot. - That's it. One click. Do it monthly, and always immediately before an update.
- Belt-and-braces (recommended, since this Mac's Documents folder is what it is): occasionally copy the newest archive from
Backups/onto a USB stick or another disk. A backup that lives only next to the original protects against mistakes, not against a dead disk.
RECOVERYRestoring
- Everything broke / settings mangled: restore the most recent archive from
Backups/via FreeShow's settings (the restore lives beside "Backup everything"). If no recent backup exists,_backup-2026-08-20is the known-good floor — templates, styles, projects, and connections as this course describes them. - One show accidentally wrecked: shows are individual
.showfiles underShows/— a single file can be pulled out of a backup archive without touching anything else. - After any restore: run the Lesson 4.3 checklist once (style, project, scripture, remote) to confirm the world is back.
DISCIPLINEUpdating FreeShow safely
Updates come from freeshow.app (this Mac runs 1.6.4). Updates bring fixes — and occasionally moved menus. The discipline:
- Never update on a Sunday morning. Or Saturday night. Tuesday is an update day; Sunday is a stability day.
- Backup first, every time. "Backup everything" → then update.
- Verify after. Open FreeShow, run the pre-service checklist against a practice project: style switch works, scripture presents, remote connects (ports and password survive updates, but verify — that's the point).
- If anything looks wrong post-update and Sunday is near: restore the backup, stay on the old version, and investigate on a weekday.
A macOS upgrade the night before a service can change display arrangements and permissions. Same rule: system updates on weekdays, with a test run after.
TRY IT NOWThe maintenance drill
1. Run "Backup everything" now, and confirm a new archive appeared in ~/Documents/FreeShow/Backups (Finder is fine for looking). 2. Open Shows/ and find a hymn's .show file — just to see that shows really are files. 3. Peek into _backup-2026-08-20 so you know what the known-good floor contains. 4. Put a monthly "FreeShow backup" reminder in your phone. Done — you're the kind of operator who never loses a library.
RECAPWhat to remember
- Everything lives in
~/Documents/FreeShow—Shows/,Bibles/,Backups/, plus the_backup-2026-08-20known-good snapshot. - "Backup everything" = one click, archive into
Backups/. Monthly, and before every update. Copy one off-machine now and then. - Restores: whole archive for disasters, single
.showfile for one broken song; checklist afterward. - Updates: weekdays only, backup first, verify after — for FreeShow and macOS alike.
ACTIVE RECALLCheck your understanding
Answer in your own words first, then reveal.
1FreeShow 1.7 is out and it's Saturday evening. What do you do?›
Nothing. Sunday runs on 1.6.4. Tuesday: "Backup everything" → update → verify with the checklist.
2Someone mangled the Announcements show badly. Do you need a full restore?›
No — shows are individual .show files in Shows/. Pull just that file from the latest backup archive. (Often ⌘Z in the app fixes it even faster.)
3Why copy a backup archive to a USB stick when Backups/ already exists?›
Backups/ sits on the same disk as the original. It protects against mistakes; only an off-machine copy protects against the disk itself failing.
GRADUATIONYou made it
You know the map (Stage 1). You can build a branded service for either church from the template (Stage 2). You can present any passage in two languages and add any song legally (Stage 3). You can run it live from keyboard or phone, with a printed runbook and two-minute fixes (Stage 4). Print the runbook, do a dress rehearsal this week — and next Sunday, be the calmest person in the room.