# WorshipFlow Desktop — User Manual
**Version 0.6.0-beta.1** · Developed by **KingdomFlow Technologies** ·
A complete, beginner-friendly guide to installing and operating WorshipFlow for live worship.
---
## Table of contents
1. [Introduction](#1-introduction)
2. [Branding, copyright & trademarks](#2-branding-copyright--trademarks)
3. [Features & advantages](#3-features--advantages)
4. [Installation guide](#4-installation-guide)
5. [Complete interface guide](#5-complete-interface-guide)
6. [Step-by-step tutorials](#6-step-by-step-tutorials)
7. [Recommended church workflow](#7-recommended-church-workflow)
8. [Troubleshooting & safety](#8-troubleshooting--safety)
9. [Founding 20 beta tester program](#9-founding-20-beta-tester-program)
---
## 1. Introduction
**WorshipFlow Desktop** is a Windows application for presenting worship content — song lyrics, Scripture, text, and background images or video — on a projector or second screen during a church service.
**Why it was developed.** Many churches rely on a single volunteer to run the words each week, often with tools that are complicated, expensive, or dependent on a reliable internet connection. WorshipFlow was built by KingdomFlow Technologies to be **offline-first**, straightforward, and calm to operate, so that a volunteer can prepare a service quickly and run it confidently.
**What it helps you do:**
- Keep your church's songs in one place and reuse them every week.
- Plan a service as an ordered list of songs, Scripture, text, and media.
- Preview what the congregation will see before you show it.
- Send lyrics and Scripture to a projector cleanly, with readable text over backgrounds.
- Hide the screen (Black), clear the words, or show a logo instantly.
**Who benefits:** local churches, worship teams, pastors, and media ministries — especially volunteer operators and first-time users.
**Offline-first advantages:** once installed, WorshipFlow needs no internet to run a service. Your library lives on your computer, so there is no subscription, no account, and nothing to load during the meeting. (Internet is used only to look up a Bible passage the first time, and to open website links.)
**Within KingdomFlow Technologies.** WorshipFlow is one of KingdomFlow Technologies' ministry software projects. Its mission is shared with the wider work: *making practical ministry tools accessible to churches and helping volunteers serve effectively.* WorshipFlow is a distinct product and is **not** the same as **KingdomFlow Ministry Studio**.
---
## 2. Branding, copyright & trademarks
- **Product:** WorshipFlow Desktop
- **Developed by:** KingdomFlow Technologies
- **Official website:**
- **Notice:** © 2026 KingdomFlow Technologies. All rights reserved.
- **Trademark:** WorshipFlow™ is a trademark of KingdomFlow Technologies. The ™ symbol indicates a claimed mark; no claim of trademark *registration* is made.
**Please note:**
- WorshipFlow is a KingdomFlow Technologies software project, separate from KingdomFlow Ministry Studio.
- Third-party names and trademarks — Microsoft and PowerPoint, CCLI and SongSelect, Bible publishers, and other worship programs (FreeWorship, OpenLP, EasyWorship, OpenSong) — belong to their respective owners. WorshipFlow is **not affiliated with, sponsored by, or endorsed by** any of them.
- **You are responsible** for ensuring you have the rights to display the song lyrics, media, and Bible translations you use — for example a valid **CCLI** or equivalent licence where your use requires one. WorshipFlow provides no such licence and ships no copyrighted lyrics.
- WorshipFlow makes **no legal guarantee** about your use of copyrighted material. If in doubt, check with your licensing provider.
---
## 3. Features & advantages
### Fully working in this release
| Feature | What it does | Benefit |
|---|---|---|
| **Song library** | Create, edit, duplicate, and delete songs; lyrics use `[Verse 1]`, `[Chorus]` labels that become slide markers but never appear on the projector. | One tidy, reusable library. |
| **Import songs** | Bring in songs from FreeWorship, OpenLP, EasyWorship 6+, OpenSong, ChordPro, CCLI SongSelect text files, and plain text. Sources are read-only; duplicates are skipped. | Move your existing library in minutes. |
| **Service builder** | Arrange songs, Scripture, text, media, background music, countdown timers, and section headers into an order. | A clear service plan. |
| **Slide previews** | Each item is split into slides you can preview before showing. | No surprises on screen. |
| **Live presentation controls** | Go Live, Previous/Next, **Show / Black / Clear / Logo**, with keyboard shortcuts. | Fast, calm operation. |
| **Projector / second display** | A clean, full-screen output window for a projector or second monitor. | Professional output. |
| **Scripture lookup** | Public-domain Bibles (WEB, KJV, BSB, ASV, and more); fetched once, then cached offline. | Scripture on screen without typing it out. |
| **Image & video backgrounds** | JPG/PNG/WebP/GIF images and MP4/WebM/MOV video, plus solid-colour and gradient fills, with a readability overlay. | Readable words over any background. |
| **Background music** | MP3/WAV/M4A/OGG that keeps playing across slides, timers, and Black/Clear/Logo. | Seamless pre-service and transitions. |
| **Keyboard shortcuts** | Arrow keys, Space, B/C/L, Esc. | Operate without hunting for buttons. |
| **Appearance & themes** | Dark, Light, System, Midnight for the operator screens only. | Comfortable in any room; projector unaffected. |
| **Local data storage** | Everything stored on your PC under `%APPDATA%`. | No account, no cloud, full control. |
| **Backup & restore** | Save and restore your whole library as a single file. | Protect your work. |
| **Offline operation** | No internet needed to run a service. | Reliable even with no connection. |
### Partial / external
- **PowerPoint presentations (.ppt/.pptx/.pps/.ppsx).** WorshipFlow **opens the file in Microsoft PowerPoint (or your default app) as a separate window**. It does **not** render or control PowerPoint slides inside WorshipFlow. If PowerPoint is not installed, the file opens in whatever app Windows has associated with it. *(Verified: external open only.)*
### Not in this build
Automatic updates, a phone/tablet remote, a separate stage-display screen, and an OBS/streaming browser output are **not** included in 0.6.0-beta.1.
**Overall advantages:** reduced preparation time, an organised service flow, simple live operation, and reliable projection that works offline.
---
## 4. Installation guide
For a non-technical Windows user.
1. **Download the authorized installer.** Get `WorshipFlow-Setup-0.6.0-beta.1.exe` from the contact named in your tester invitation. Do not download WorshipFlow from unknown websites.
2. **Verify its source.** Confirm the file's checksum matches the SHA-256 value you were sent. In PowerShell, in the download folder:
```powershell
Get-FileHash .\WorshipFlow-Setup-0.6.0-beta.1.exe -Algorithm SHA256
```
The result must equal the value in your invitation. If it does not match, **do not install it** — report it.
3. **Run WorshipFlow Setup.** Double-click the installer and follow the steps. You can keep the suggested install folder. It creates a Desktop and Start Menu shortcut.
4. **Understand the unsigned-publisher warning.** This beta is **not code-signed**, so Windows SmartScreen shows a blue **"Windows protected your PC / Unknown publisher"** box. Click **More info**, then **Run anyway**. This is expected for an beta and will go away in a signed release. **Do not turn off antivirus or Windows Defender** to install WorshipFlow.
5. **Open the application.** Launch WorshipFlow from the Desktop or Start Menu. The first launch sets up your local library automatically.
6. **Complete initial setup.** On the dashboard, your church is created automatically (you can rename it later in **Settings → General**).
7. **Prepare your first worship service.** Add a few songs (Section 6A), then build a service (Section 6B).
**Verified Windows requirements:** Windows 10 or 11, 64-bit; about 300 MB free disk space. Installer size ≈ 127 MB. Publisher: KingdomFlow Technologies. Signature: **not signed** (beta).
---
## 5. Complete interface guide
WorshipFlow has two main areas: the **Dashboard** (home) and, for each service, the **Control Room** (the live operating screen). There is also a drag-and-drop **Builder** for planning.
### 5.1 Dashboard (home screen)
- Title **WorshipFlow™** and your church name.
- Top navigation: **Songs**, **Services**, **Templates**, **Settings**, **Help**.
- **Help** opens the built-in documentation (this manual, the Quick Start, the Tester Guide, and About), readable **offline**, with a **Send Feedback** button.
- Three cards: **Services** (*Build a Service*), **Songs** (*Open Song Library*), and **Presentation Screen** (*Open Display* — opens the clean output window).
- **Recent Services**, each with **Build** and **Present** buttons.
- An optional **Buy a Coffee** note (support the creator) — never shown during live operation; it can be hidden.
### 5.2 Song Library (Songs page)
- **+ New Song** to create a song; **Import Songs** to bring in songs from other programs.
- Each song shows its title and author; right-click (or the **⋯** menu) for **Edit Lyrics**, **Add to Service**, **Duplicate**, and **Delete**.
- Lyrics use blank lines to separate slides and `[Verse 1]`, `[Chorus]`, `[Bridge]` style labels that become slide markers but are **not** shown on the projector.
### 5.3 Control Room (the live screen)
Open it with **Present** on a service. It has a top bar, a Library panel, a Service list, and the monitors with live controls.
**Top bar**
- **WORSHIPFLOW** and the current service name.
- **Open projector** button (shows **Projector connected** once open) — click to open the output window on the second screen.
- Clock, a **fullscreen** toggle, a **Builder** link, and **⚙️ Settings**.
**Library panel (left)** — tabbed:
- **Songs** — your song list, with **+ New** and a search box; click a song to add it to the service.
- **Scripture** — look up a Bible passage and add it.
- **Media** — image and video backgrounds, and audio (▶ to play as background music).
- **Presentations** — PowerPoint files (open externally).
**Service list (middle)** — the ordered items of the service, with a toolbar:
| Button | Action |
|---|---|
| ✏️ | **Edit** the selected item |
| 🏷 Header | Add a **section header** (e.g. *Worship*, *Sermon*) |
| ⏱ Countdown | Add a **countdown timer** |
| ▲ / ▼ | **Move** the selected item up / down |
| ⧉ | **Duplicate** the selected item |
| ✕ | **Remove** the selected item |
Right-clicking an item shows **Edit / Duplicate / Move / Remove**. Section headers are dividers only — they are never numbered, have no slides, are never shown on the projector, and Next/Previous step over them.
**Slide workspace & monitors (right)**
- **Preview** monitor — what you are lining up next. Click a slide to select it; **double-click** or press **Go Live** to send it to the projector.
- **Live** monitor — exactly what the projector is showing right now.
- **The difference between Preview and Live:** *Preview* is private to the operator (choose and check the next slide); *Live* is what the congregation sees. Nothing reaches the projector until you **Go Live**.
**Live controls (bottom)**
| Control | Keyboard | Effect |
|---|---|---|
| **Show** | **Esc** | Return to the normal slide (words + background). Lit green while showing. |
| **Black** | **B** | Black screen (nothing shown). |
| **Clear** | **C** | Clear the words but keep the background. |
| **Logo** | **L** | Show the logo screen (set in Settings → Presentation). |
| **◀ Prev** | **←** or **Page Up** | Previous slide (live). |
| **Go Live** | — | Send the selected Preview slide to Live. |
| **Next ▶** | **→**, **Page Down**, or **Space** | Next slide (live). |
Keyboard shortcuts are ignored while you are typing in a text box or when a dialog or right-click menu is open, so they never fire by accident.
### 5.4 Settings
Open from the Dashboard (**Settings**) or the Control Room (**⚙️ Settings**). Tabs:
- **General** — church name; safety confirmations; "This computer" (version and data locations).
- **Appearance** — operator theme: **Dark**, **Light**, **System**, **Midnight**. *These change the operator screens only; the projector is never themed.*
- **Presentation** — background readability overlay and strength; **slide transition** (None or Fade) and length; background fit (fill or fit); the **Logo screen** title/subtitle; and a shortcut reference.
- **Songs** — import songs from another program.
- **Bible** — default Bible version and which translations are included.
- **Media** — your media counts, supported formats, **Open Media Folder**, and a performance toggle for video on the operator screen.
- **Backup** — **Create Backup** and **Restore Backup**.
- **About** — version, **Check for Updates**, **Visit Website**, **Contact Support**, **☕ Buy a Coffee**, and the copyright/trademark notice.
> **Screenshots:** none are embedded in this manual. Capture them from your own installed copy if you need illustrated internal documentation; this guide uses the exact on-screen names so it can be followed without images.
---
## 6. Step-by-step tutorials
Menu paths and shortcuts below are verified against the application.
### A. Adding and editing a song
1. Dashboard → **Songs** (or Control Room → Library → **Songs**).
2. Click **+ New Song** (or **+ New**).
3. Type the **title**, optional **author**, and the **lyrics**. Separate slides with a **blank line**; name sections with labels like `[Verse 1]`, `[Chorus]`, `[Bridge]`.
4. Save. To change a song later, right-click it → **Edit Lyrics** (or the ✏️ button), edit, and save. Slides already in services update to the new words while keeping their backgrounds.
### B. Creating a worship service
1. Dashboard → **Services** → **Build a Service** (or **New / Manage Services**).
2. Give the service a name.
3. Add items: from the Library, click a **song**, look up a **Scripture**, add **text**, a **background**, **music**, a **countdown**, or a **section header**.
### C. Arranging songs in service order
1. Open the service in the **Control Room** (**Present**) or the **Builder**.
2. In the Builder, **drag** items into order. In the Control Room service list, select an item and use **▲ / ▼** to move it.
3. Add **🏷 Header** dividers (e.g. *Worship*, *Sermon*) to group the plan.
### D. Selecting and editing slides
1. In the Control Room, click an item to load its slides into **Preview**.
2. Click a slide to select it. Right-click a slide for options such as **Edit Text** and background choices.
3. Blank lines in lyrics/text decide where slides break.
### E. Choosing image or video backgrounds
1. Control Room → Library → **Media**.
2. Add the background you want to a slide or item. Images: JPG/PNG/WebP/GIF. Video: MP4/WebM/MOV (loops silently as a background).
3. Keep the **readability overlay** on (Settings → Presentation) so white text stays readable over bright images.
### F. Finding and displaying Bible passages
1. Control Room → Library → **Scripture**.
2. Choose a version (default is **WEB**; others include **KJV**, **BSB**, **ASV**, and more — all public domain) and type a reference, e.g. `John 3:16` or `Psalm 23`.
3. Add it to the service and show it like any other item. *The first lookup of a passage needs internet; after that it is cached and works offline.* Copyrighted translations (NIV, ESV, NLT, etc.) are **not** included.
### G. Connecting a projector using Windows Extend mode
1. Plug the projector/second screen into your PC.
2. Press **Windows + P** and choose **Extend** (not Duplicate), so the projector is a *separate* screen.
3. In the Control Room top bar, click **Open projector**. WorshipFlow opens the clean output window on the second screen; the button then reads **Projector connected**.
4. If you only have one screen, you can still open the output window (Dashboard → **Open Display**) to check it.
### H. Sending slides from Preview to Live
1. In **Preview**, click the slide you want next.
2. Press **Go Live** (or **double-click** the slide). It now appears on **Live** and on the projector.
3. **Preview** is private; nothing shows on the projector until you Go Live.
### I. Using Black, Clear, Logo, Next, and Previous
- **Black (B)** — hide everything (e.g. during prayer).
- **Clear (C)** — remove the words but keep the background.
- **Logo (L)** — show your logo screen.
- **Show (Esc)** — return to the normal slide.
- **Next (→ / Page Down / Space)** and **Previous (← / Page Up)** — move through the live slides.
### J. Changing appearance settings
1. **Settings → Appearance**.
2. Choose **Dark**, **Light**, **System**, or **Midnight**. This changes only the operator screens; the projector keeps its own look. The choice is remembered.
### K. Backing up and restoring WorshipFlow data
1. **Settings → Backup → Create Backup.** Save the `.zip` somewhere safe (not only on this PC). It contains your database, media, and settings.
2. To restore: **Settings → Backup → Restore Backup**, choose the `.zip`, and confirm. WorshipFlow checks the file and keeps your current data until the restore has safely completed, then restarts.
### L. Safely ending a presentation
1. Press **B** (Black) or **Esc**/**Show** as the service closes, as your church prefers.
2. Close the projector window (click **Projector connected** again, or use the close control).
3. If you made changes, they are saved automatically; for safety, **create a backup** (Section K).
---
## 7. Recommended church workflow
### Before the service (preparation)
1. Add or update **songs** for the week.
2. Look up and add any **Scripture** passages (do this while you have internet, so they cache).
3. Choose **backgrounds** and any **background music**.
4. Build the **service order**; add **🏷 Header** dividers (Welcome, Worship, Word, Response).
### During rehearsal
1. Connect and test the **projector** (Windows + P → **Extend**; **Open projector**).
2. Check **text readability** over your backgrounds; adjust the overlay if needed.
3. **Preview** every item and step through the slides.
### During the service
1. Follow the service order; use **Go Live** and **Next / Previous**.
2. Use **Black** during prayer or talks, **Clear** to keep a background without words, **Logo** between sections.
3. Keep an eye on the **Live** monitor — it mirrors the projector.
### After the service
1. Save any changes (automatic) and **create a backup** (Settings → Backup).
2. Close the projector window and WorshipFlow.
### Sunday operator checklist
- [ ] Service opens in the Control Room; items are in order.
- [ ] Projector connected (Extend mode); output looks correct.
- [ ] First song previewed; text readable over the background.
- [ ] Scripture passages load (cached from earlier).
- [ ] Background music ready (if used).
- [ ] Black / Clear / Logo tested.
- [ ] A **backup plan** is ready in case of a problem (see Section 9).
- [ ] After the service: backup created.
---
## 8. Troubleshooting & safety
| Problem | What to check |
|---|---|
| **Projector not detected** | Press **Windows + P** → **Extend**. Reseat the cable. Click **Open projector** again. If the projector monitor is unplugged mid-service, WorshipFlow automatically moves the output window off it so it cannot cover your operator screen; re-open it after reconnecting. |
| **Lyrics not displaying** | Make sure you pressed **Go Live** (Preview does not show on the projector). Check you are not in **Black** or **Clear** — press **Show / Esc**. |
| **Missing background files** | If a background was removed from the Media folder, the slide still shows the words without that background. Re-add the file via Library → **Media**. |
| **Video playback problems** | Use MP4 (H.264) where possible. On slower laptops, turn off "Play video backgrounds on the operator screen" (Settings → Media); the projector still plays the video. |
| **Application not opening** | Reopen from the Start Menu. If it still fails, note the on-screen message and send the log (below). Your data is safe in `%APPDATA%\worshipflow-desktop`. |
| **Windows security warning** | The unsigned-installer SmartScreen box is expected: **More info → Run anyway**. **Do not** disable antivirus or Windows security. |
| **Local library errors** | Use **Settings → Backup → Restore** with a recent backup. |
| **Backup / restore issues** | Restore only a WorshipFlow `.zip` backup. WorshipFlow checks the file first and keeps your current data until the restore succeeds, so a bad file will not wipe your library. |
**Safety rules**
- **Do not delete or edit files in `%APPDATA%\worshipflow-desktop`** (the database and media) by hand. Use **Backup/Restore** instead.
- Keep **regular backups**, especially before importing a large library or trying a new version.
- This is **beta software** — always have a **backup way to show words** during a live service (a second device, printed sheets, or another program).
**Sending a log for help.** In File Explorer, open `%APPDATA%\worshipflow-desktop` and attach `worshipflow-server.log` to your message. It holds file paths and version info for troubleshooting — glance at it and remove anything you prefer not to share.
---
## 9. Founding 20 beta tester program
This release is for a **limited group of up to 20 invited testers**.
- WorshipFlow is provided **free of charge**.
- **Founding testers keep free access** as the software grows.
- Your **feedback directly shapes** the first public release.
- As **beta software, it may contain bugs**. Please **keep a backup presentation method** ready during live services.
- The easiest way to send feedback is built in: **Help → Send Feedback** (or **Settings → About → Send Feedback**). It shows a short form, lets you review **exactly what will be saved**, and saves it to a text file you choose — **nothing is uploaded automatically**, and no church data, lyrics, or files are included. You then send that file through the **official contact or form provided with your invitation**, or the contact section of . *(This manual does not publish a feedback address or download link; use the one you were given. A positive review is never required.)*
- Save your **Tester ID** (from your invitation) in **Settings → About** so it is attached for you.
- **Settings → About → Check for Updates** tells you when a newer version is on your channel (Beta or Stable). WorshipFlow never installs an update by itself — you download the verified installer and run it when you choose.
See **[WorshipFlow-Alpha-Tester-Guide.md](WorshipFlow-Alpha-Tester-Guide.md)** (the controlled-beta tester guide) for exactly what to test and how to report.
---
© 2026 KingdomFlow Technologies. All rights reserved. WorshipFlow™ is a trademark of KingdomFlow Technologies. WorshipFlow Desktop is a distinct product from KingdomFlow Ministry Studio.