Documentation

Introduction to StageFlo

StageFlo is a live worship presentation app for songs, scripture, media, and synchronized projector and stage outputs. Built for real service flow — fast prep, simple control, and confidence on stage.

Full README Ask for Help

Core Workflow

Most teams use this sequence every week:

Build a service plan with songs, scriptures, media, and custom slides.
Style text and backgrounds in the editor.
Preview transitions and timing in operator view.
Go live to projector and stage displays.
Control slides with keyboard shortcuts or the remote controller.

Settings — Remote Control

Found in Settings → Remote. Control slides from any phone, tablet, or browser and show a stage monitor on any screen.

Local Network

Opens a local web server on your machine. Connect any device on the same Wi-Fi to the shown URL or scan the QR code. Use /remote for the controller and /stage for the singer view.

Public Link (Cloudflare)

Generates a live public URL via Cloudflare Quick Tunnels — no account needed. One click creates a trycloudflare.com address for both the remote controller and stage view. QR codes are provided for both. Use this when devices are on different networks or for off-site team access.

PIN Protection — Set a PIN in Remote → Security to restrict access to the controller. Leave blank for open access on trusted local networks.

Settings — Display

Controls typography and slide layout for all outputs. Found in Settings → Display.

Font — Choose the typeface used across all slide text.
Size — Base font size for slide text.
Style — Weight and style variations (bold, regular, etc.).
Alignment — Horizontal text alignment for slide content.
Color — Default text color applied to new slides.

Use the Reset button in Display Settings to restore factory defaults if slide layouts look incorrect after a font change.

Settings — Stage Display

Configures the confidence monitor shown to speakers and musicians on stage. Found in Settings → Display → Stage Display.

Template — Choose a layout preset: Classic (full detail), Focus (larger text), or Compact (current slide only).
Accent Color — Highlight color for the active/current panel.
Show Clock — Toggle a live clock on the stage display.
Clock Format — 12-hour or 24-hour format.
Show Status — Show current presentation status (live, clear, black).
Show Next Slide — Preview the upcoming slide (disabled in Compact).
Show Stage Timer — Display a running stage timer.
Show Info Panel — Show operator notes and additional context.

Settings — Lower Third

Configures the lower-third overlay for live streaming. Found in Settings → Display → Lower Third. Use the static URL in OBS as a browser source.

Style — Select a lower-third visual style. Each has its own description and URL.
Font — Typeface used for lower-third text.
Primary Color — Main text or accent color.
Secondary Color — Supporting color for subtitle or background elements.
Bottom Offset % — Vertical position from the bottom of the frame.
Panel Opacity — Transparency of the lower-third background panel.
Show Second Line — Toggle display of the subtitle/secondary text line.

In OBS, add a Browser Source and paste the static lower-third URL from Settings. It updates in real time as slides change — no re-linking needed between services.

Settings — Screens & Outputs

Routes content to audience and stage displays. Found in Settings → Display → Screens.

Screen Assignment

Assign each output (Projector, Stage, Lower Third) to a connected display. Use Identify Screens to show numbers on each monitor and Test Pattern to verify signal and alignment.

Output Modes

Single — one display per output. Grouped / Edge Blend — span across multiple displays with column and overlap controls for multi-projector rigs.

Color Overlay

Tint the output with a solid color. Useful for matching projector color temperature or applying a stage wash effect.

Corner Pin

Keystone / perspective correction. Drag the four corners of the output to correct for angled projection surfaces.

Alpha Key

Enable alpha keying for broadcast or video mixing workflows. Choose key type, key color, and fill color for transparency compositing.

NDI Output

Send the output as an NDI stream on the local network. Set a source name and framerate. NDI receivers (e.g. OBS NDI plugin) can pick up the feed directly.

Settings — Bible

Manage Bible translations used in presentations. Found in Settings → Bible.

Download a Translation — Browse available translations, select a version, and download it directly into StageFlo. No external files needed.
Import XML — Import a Zefania-format or compatible Bible XML file. Useful for languages not available in the built-in library.
Installed Translations — View and delete installed translations to manage storage.

For multilingual services, install multiple translations. You can switch the active Bible while building slides without leaving the app.

Settings — Songs

Import, export, and manage your song database. Found in Settings → Songs.

Song Pack — Import a pre-built song pack (OpenLyrics XML format) to populate your library instantly. Language packs for Malayalam, Tamil, Hindi, and others are available.
Import Songs — Import individual songs or bulk XML files from your file system.
Export Songs — Export your entire library as an XML file for backup or sharing with another StageFlo installation.
Delete All Songs — Clears the entire database. Use before re-importing a clean pack.

Settings — Keyboard Shortcuts

Customise key bindings for live control. Found in Settings → Keyboard Shortcuts. Click the + icon on any action to capture a new key combo.

Next / Previous Slide — Advance or step back through the playlist.
Black Screen — Toggle a black output on all displays.
Clear — Clear slide content, showing the background or standby image.
Close Outputs — Close all output windows.
All shortcuts can be reset to factory defaults with the Reset button.

Toggle the Keyboard Shortcuts enable switch to temporarily disable all bindings — useful when typing in text fields during a live service.

Outputs and Displays

Projector — Full-screen congregation output for lyrics, scripture, and media.
Stage Display — Confidence monitor for speakers and musicians with current + next slide context.
Lower Third — Overlay stream for song titles and speaker names in OBS or broadcast tools.
Mobile Stage View — Open /stage from the Remote URL on any phone — singers see live lyrics without a dedicated monitor.
Layer Controls — Black, Clear, and Restore controls for instant live transitions.

Run Your First Service

Install StageFlo from the downloads page and launch the app.
In Settings → Songs, import a song pack or add songs manually.
In Settings → Bible, download or import a translation.
Build a service plan with 2–3 songs and one scripture passage.
Open Settings → Display → Screens and assign your projector and stage outputs.
Open Remote settings, copy the stage URL, and open it on a mobile device for the singer view.
Practice Next/Previous controls with keyboard shortcuts before going live.

Troubleshooting

Remote page doesn't load — confirm app and device are on the same local network, or switch to Public Link mode in Remote settings.
Output on wrong screen — re-assign displays in Settings → Screens and reopen the output windows.
Cloudflare tunnel fails to start — check internet connectivity; the tunnel requires outbound access to trycloudflare.com.
Media file missing — re-import the file; StageFlo references local paths so moved files need re-linking.
Text too small on stage display — adjust font size in Display Settings and increase the base size.
Bible not found after import — go to Settings → Bible, verify the translation shows in Installed, and restart the app if needed.

Known Issues Submit Feedback