Install

Lyrics Presentation runs on the church computer, next to OBS—not in the cloud. It is free for churches. Commercial use requires a purchase. See Terms.

What you need

• A Windows PC that will run the service (the booth machine is typical).
• The portable kit: a folder named LyricsPresentation (zip from us after you sign up).
• OBS if you key or mix the house output. A second monitor or projector works without OBS.

You do not install Node, Git, or npm on that PC. The kit includes a small Node runtime.

Install

• Unzip the kit somewhere stable, such as C:\LyricsPresentation or a folder on the booth drive.
• Do not run it from inside the zip. Do not put it in a folder that gets wiped by a weekly “temp clean.”
• Optional: pin Start Lyrics Presentation.bat to the taskbar or a desktop shortcut.

Run

• Double-click Start Lyrics Presentation.bat.
• Leave that window open while you present. Closing it stops the app.
• The presenter opens at http://localhost:3000 unless you changed the port.
• In OBS, add a Browser Source: http://localhost:3000/live, width 1920, height 1080. Stage monitors: /stage and /boh.

If the browser says the site can’t be reached, wait a second and refresh, or check that nothing else is using the port.

Songs live in the kit’s data folder (library.json). That folder is the library.

Change the port

The app listens on port 3000 by default. If that port is already in use, set LYRICS_PORT — not a generic PORT variable.

Portable kit: open lyrics.env next to Start Lyrics Presentation.bat and set:

LYRICS_PORT=3001

Save the file, start the app again, then point OBS at the new URLs:

• Presenter: http://localhost:3001
• House: http://localhost:3001/live
• Stage: http://localhost:3001/stage
• BOH: http://localhost:3001/boh

You can also set LYRICS_PORT as a Windows user environment variable. The kit’s lyrics.env is the usual way on a booth PC.

Upgrade without losing songs

Do this every time you replace the kit:

• Export first. In the running app: Library → Export. Save lyricslides-library.json somewhere safe (USB, shared drive, the old folder).
• Unzip the new kit into a new folder (or rename the old folder, then unzip). Do not drop new files on top of the old folder until you have a copy of data.
• Copy the old data folder into the new kit, replacing the empty one—or start the new kit and Library → Import.
• If you changed the port, copy your old lyrics.env into the new kit so LYRICS_PORT stays the same.
• Import asks whether to replace the whole library or merge. Cancel on that prompt to merge; OK to replace. After a clean upgrade, replace is usually right if you exported the full library. Merge if you only want to add songs.
• Start the new kit, confirm songs and the service set, then point OBS at the URLs for your LYRICS_PORT (3000 unless you changed lyrics.env).
• Keep the old folder until you have run one Sunday on the new one.

Do not delete data\library.json to “make room” for an upgrade. That file is your catalog.

License

The kit includes LICENSE.txt. Churches may use the software for worship and ministry at no charge. Commercial use requires a purchase. Full terms: lyricspresentation.com/terms.