Documentation

User Guide

Everything you need to run a service in PraiseMates — from first activation to styling what your congregation sees on screen. Most of this you'll never need to read twice.

Getting Started

On a brand-new install, PraiseMates shows a prompt in the middle of the window:Activate your license to get started.

  1. Click Activate License.
  2. In the dialog, click the button to activate via your browser. PraiseMates opens the activation page on portal.praisemates.com— sign up or sign in there, and the app picks up activation automatically.
  3. If your browser doesn't open automatically, or you're signed into the portal in a different browser, use Copy Link and paste the activation URL wherever you need it.

You have about 20 minutes to complete signup, email verification, and sign-in before the activation link expires — if it does, just click Activate License again.

If your subscription lapses later, the same dialog reappears with Activate Licenseand Go to Dashboard options, the latter taking you straight to your account.

Libraries & Setlists

The left pane has two tabs for organizing your songs: Libraries and Setlists.

Libraries

Libraries are permanent collections — your full song catalog, organized however makes sense to you (by language, by ministry, whatever). Click + New Library, type a name, and press Enter. Right-click a library to rename or delete it.

Setlists

Setlists are for a specific service. Click + New Setlist, then use the search box under it to find songs and add them with the + next to each result. Drag songs by their handle to reorder them for the service. Right-click a setlist to rename or delete it.

Songs

Importing lyrics from .txt

Go to Import → Lyrics in the menu bar. You can select multiple .txtfiles at once. Pick which library to import into, and PraiseMates converts each file into slides automatically. If a song with the same name already exists, you'll be asked whether to overwrite it.

For the import to come out right, format your text file like this:

  • The file name becomes the song title (so Amazing Grace.txt imports as "Amazing Grace").
  • A blank line separates one slide from the next.
  • Wrap a line in square brackets — like [Verse 1] or [Chorus] — to mark it as a section label instead of a lyric slide.
[Verse 1]
Amazing grace, how sweet the sound
That saved a wretch like me

[Chorus]
My chains are gone
I've been set free

Editing a song manually

Select a song to see its slides in the Preview column. Click Edit to make slide text editable, duplicate or delete individual slides, and drag to reorder them. Click Cancelto discard changes, or leave edit mode to save.

Double-click a slide in Preview — or click Make Live — to push the whole song to the Live panel and start presenting it.

Right-click a song in the list to rename it, delete it, or remove it from the current setlist.

Bible

Switch to Bible mode from the top bar. The left pane lets you pick a translation, browse by book and chapter, and keeps a running Schedule (drag to reorder, right-click to remove) and Verse History for the service.

Finding and presenting a verse

In the center pane, use the search box to search by reference or by text, or just browse the current chapter. Double-click a verse to load its chapter and present it live. Right-click any verse to add it to the Schedule for later. Once a chapter is loaded, you can also select any verse in the Live column to jump straight to it.

Importing a translation

Go to Import → Bible (XML) and select an XML export of a translation. PraiseMates reads the file's structure automatically — there's no fixed schema to match, it just needs to look like a real Bible (all 66 books, consistent chapter/verse counts). You'll get a preview where you name the translation and set its abbreviation before confirming.

Going Live

The top bar switches between Songs, Bible, and Slidesmodes, with a Go Live button in the center to toggle presentation on and off, plusCue, Timer, and Clear alongside it.

The right pane shows live-updating previews of both your Crowd and Stagescreens, so you always know what's currently on each display before you change it. From there you can:

  • Swap Screens — instantly swap which physical monitor shows Crowd vs. Stage.
  • Profile — switch between saved presentation styles for the current mode.
  • Quick Media — drop in a CLR, image, or video background without leaving the flow.
  • Video Controls — stop, play, or mute background video.
  • Bilingual (Bible mode) — present two translations together.

Crowd, Stage, and NDI all present the same live content, each styled independently (see Styling Your Outputs below).

Media

Click + Import Media on the bottom pane to import videos and images. These can be used either as a background loop, or a generic Audio Visual. The four buttons to the far right of this import button - the first pair will be image/video toggle, The other two will be list/grid view toggle. Click any media item in the list to set it as the current background. Right-click to rename or delete.

Slides (PDF)

Switch to Slides mode to present PDFs — each page is turned into a slide image automatically. Click Import PDF, and imported files appear as a thumbnail grid; right-click to delete one.

While in Slides mode, PraiseMates responds to common presentation clicker key bindings, so most clickers work without any setup. If that doesn’t work, PraiseMates’ Remote Control is the safer bet.

  • Next slide: Right, Down, Page Down or N
  • Previous slide: Left, Up, Page Up or P
  • Clear / blank screen: Escape, B, or period (.)

Styling Your Outputs

Open Presentation Settings from the right pane's settings stack to control how Crowd, Stage, and NDI each look — they're styled independently, with their own tab and their own saved profiles per mode (Songs vs. Bible).

Bible layouts break settings further into Verse, 2nd Translation,Reference, and Positioning sub-tabs, each with font family, weight, size, uppercase, line height, drop shadow, and outline controls, plus a live 1920×1080 preview.

One asymmetry worth knowing: Stage's reference text is a plain text block with no outline or shadow support, while Crowd and NDI reference text supports full stroke and shadow styling.

Output Settings

Open Output from the right pane's settings stack for where things render, as opposed to how they look:

  • Screens — assign Crowd and Stage to specific monitors, with manual position/size overrides and a Swap Screens shortcut.
  • OBS Websocket — connect PraiseMates to OBS for streaming integration. (This output will be discontinued in future versions).
  • NDI — broadcast your live lyric/verse text (with its styling, but no video or watermark) as a transparent NDI source, even without a second display connected. Enable it, set a source name and resolution, and check the status indicator to confirm it's running.

Remote Control

Click Remote Control in the right pane to get a QR code and server URL. Scan it from your phone or another device on the same Wi-Fi network to drive live bible verses and slideshow remotely — handy for handing off control without making the speaker ask for the next slide.

Cue Messages

The Cue button in the top bar sends a short note (up to 200 characters) that appears only on the Stage screen — visible to your team, never to the congregation or on NDI/Crowd output. Use Clear in the same dialog to remove it.

Timer

The Timer button opens a stopwatch or countdown you can overlay on the Crowd and Stage previews. For a countdown, pick a quick preset (1, 3, 5, 10, 15, or 30 minutes) or enter a custom duration.

Keyboard Shortcuts

Outside of Slides mode:

  • Escape — first press clears the live lyrics/verse; press it again to also clear the background.

In Slides mode, your presentation clicker's usual buttons work directly — see the Slides section above for the full key list.