# WorshipFlow — Founding 20 Beta Tester Guide

**Version 0.6.0-beta.1** · KingdomFlow Technologies · <https://kingdomflowtechnologies.com.co/>

Thank you for being one of up to **20 invited founding testers**. This guide explains how to install safely, what to test, and how to send feedback. Please keep the installer and your invitation link **within the invited group**.

> This file is still named `WorshipFlow-Alpha-Tester-Guide.md` (so existing links keep working), but it is the guide for the **controlled beta** (0.6.0-beta.1). It is a companion to the [User Manual](WorshipFlow-User-Manual.md) and [Quick Start](WorshipFlow-Quick-Start.md). WorshipFlow also builds all of these into the app — open **Help** (top of the dashboard) to read them offline.

---

## 1. The deal

- WorshipFlow is **free of charge**. **Founding testers keep free access** as it grows.
- It is **beta software**: expect rough edges and occasional bugs.
- **Always keep a backup way to show words** during a real service (a second device, another program, or printed sheets). Do not rely on WorshipFlow alone yet.
- Your feedback **directly shapes** the first public release.

## 2. Install safely

1. **Download** `WorshipFlow-Setup-0.6.0-beta.1.exe` from the contact in your invitation. Do **not** get it from anywhere else.
2. **Verify the checksum** before installing:
   ```powershell
   Get-FileHash .\WorshipFlow-Setup-0.6.0-beta.1.exe -Algorithm SHA256
   ```
   It must equal the SHA-256 in your invitation. If not, stop and report it.
3. **Run it.** At the Windows SmartScreen **"Unknown publisher"** box, click **More info → Run anyway**. The app is **not code-signed yet** — that is expected for an beta.
4. **Do not disable antivirus or Windows security** to install or run WorshipFlow.

**Requirements:** Windows 10/11 (64-bit), ~300 MB free. Your data is stored at `%APPDATA%\worshipflow-desktop` and is kept when you update or uninstall.

## 3. First thing: make a backup habit

Before and after any serious work: **Settings → Backup → Create Backup**, and save the `.zip` somewhere safe. If anything ever looks wrong, **Settings → Backup → Restore Backup**.

## 4. What to test (checklist)

Please try each area and note anything confusing or broken.

**Songs & import**
- [ ] Create a song; check `[Verse 1]`/`[Chorus]` labels do **not** appear on the projector.
- [ ] Edit a song's lyrics; confirm slides already in a service update but keep their background.
- [ ] **Import Songs** from your previous program (FreeWorship, OpenLP, EasyWorship 6+, OpenSong, ChordPro, SongSelect text, or plain text). Did your songs come in correctly? Were duplicates skipped?

**Services & Control Room**
- [ ] Build a service with songs, Scripture, text, a background, music, a countdown, and a section header.
- [ ] Reorder items (▲ ▼, or drag in the Builder); duplicate and remove items.
- [ ] Preview vs Live: confirm nothing shows on the projector until **Go Live**.

**Projection**
- [ ] Connect a real projector/TV with **Windows + P → Extend**, then **Open projector**.
- [ ] Step through slides with **→ / ← / Space / Page Up / Page Down**.
- [ ] Test **Black (B)**, **Clear (C)**, **Logo (L)**, **Show (Esc)**.
- [ ] Unplug the projector mid-use — does WorshipFlow keep the operator screen usable?
- [ ] Does the projector stay awake during a long static slide?

**Backgrounds & media**
- [ ] Image background (JPG/PNG/WebP/GIF) and video background (MP4/WebM/MOV).
- [ ] Background music (MP3/WAV/M4A/OGG) continuing across slides and Black/Clear/Logo.
- [ ] Text readability over bright backgrounds (overlay).

**Scripture**
- [ ] Look up passages in WEB, KJV, BSB (needs internet first time), then confirm they work **offline** afterward.

**Settings & data**
- [ ] Switch themes (Dark/Light/System/Midnight) — projector should be unaffected.
- [ ] **Backup**, then **Restore**, and confirm your songs/media/settings return.

**PowerPoint (if you use it)**
- [ ] Add a `.pptx` and open it — note that it opens in **PowerPoint/your default app**, not inside WorshipFlow.

## 5. New in this beta: built-in Help, Feedback, and Update checking

- **Welcome message.** On first launch you'll see a short Founding-20 welcome with **Read Quick Start**, **Send Feedback**, and **Remind Me Later**.
- **Help (offline).** The **Help** button on the dashboard opens all four documents, built into the app and readable with no internet.
- **Send Feedback (built in).** **Help → Send Feedback**, or **Settings → About → Send Feedback**. It shows a short form, lets you see **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 ever included. You then send that file through the official contact.
- **Gentle reminder.** If you haven't sent feedback, WorshipFlow gives one quiet nudge on the dashboard after 3 launches or 7 days — never during a live service.
- **Check for Updates.** **Settings → About → Check for Updates** (Beta or Stable channel) tells you if a newer version exists and points you to the official download. WorshipFlow never installs an update by itself.

## 6. What is *not* in this build

A phone remote, a separate stage display, and OBS/streaming output are not included. PowerPoint opens externally only. Updates are **check-and-download-yourself**, not automatic/unattended.

## 7. How to report feedback

The easiest way is **Help → Send Feedback** (or **Settings → About → Send Feedback**) inside WorshipFlow, which prepares a file for you. Please include:

1. Your **Tester ID** (from your invitation) — you can save it in Settings → About.
2. **What you did**, **what you expected**, and **what happened**.
3. The **installation result** and your **Windows version** (the form can fill the technical details for you if you tick the box).
4. If it crashed, you may also attach the log yourself: `%APPDATA%\worshipflow-desktop\worshipflow-server.log` (paths and version info only; glance at it first). Attaching anything is your choice.

**Send the saved file to:** the **official contact or feedback form provided with your invitation**, or the contact section of <https://kingdomflowtechnologies.com.co/>.
*(We do not publish a feedback address or download link in this document — use the one you were given. A positive review is never required.)*

## 8. Rollback (going back a version)

1. Keep the **previous installer** and its SHA-256.
2. Uninstall the current version (your data stays).
3. Install the previous version; if needed, **Restore** a backup you made on it.

During this beta the data format does not change between versions, so your library stays compatible.

## 9. Privacy

WorshipFlow stores your songs, services, media, and settings **only on your PC**; KingdomFlow Technologies does not receive them. Internet is used only for first-time Scripture lookups and for website links you click. WorshipFlow never handles card or payment details. Any log you choose to send is used only to fix problems.

## 10. Your responsibilities

You are responsible for holding the rights to the **song lyrics, media, and Bible translations** you display (e.g. a valid CCLI or equivalent licence where required). WorshipFlow ships no copyrighted lyrics and includes only public-domain Bibles.

---

Thank you for serving as a founding tester. Your careful feedback is a real gift to the churches who will use WorshipFlow next.

© 2026 KingdomFlow Technologies. WorshipFlow™ is a trademark of KingdomFlow Technologies.