ProPresenter Lyrics Export

Logo

Extract and export worship song lyrics from ProPresenter 7

View the Project on GitHub adamswbrown/propresenterlyricexport

Getting Started

← Back to Home

Get ProPresenter Lyrics Export up and running in just a few minutes.

Table of Contents

  1. Configure ProPresenter First ⚠️
  2. Installation
  3. Next Steps
  4. Troubleshooting

⚠️ CRITICAL: Configure ProPresenter First

Before installing or using this tool, you MUST configure ProPresenter correctly. Nothing will work without this step.

Enable Network API in ProPresenter

  1. Open ProPresenter 7
  2. Go to Preferences (or ProPresenter → Preferences on macOS)
  3. Click the Network tab
  4. Check the box: “Enable Network API”
  5. Note the Port number (default: 1025)
  6. If connecting from another computer, note the IP address displayed
  7. Click OK or Save
  8. Restart ProPresenter for changes to take effect

ProPresenter Network API Settings

Why this matters: ProPresenter’s Network API is how this tool communicates with ProPresenter. Without it enabled, the tool cannot connect, read playlists, or export lyrics.

Connection details you’ll need:

Installation

The easiest way to get started with a full graphical interface.

Download:

macOS Installation:

# 1. Unzip the downloaded file
unzip ProPresenter-Lyrics-vX.Y.Z-mac.zip

# 2. Fix Gatekeeper (one-time)
xattr -cr "/path/to/ProPresenter Lyrics.app"

# 3. Move to Applications
mv ProPresenter\ Lyrics.app /Applications/

# 4. Launch the app
open /Applications/ProPresenter\ Lyrics.app

Windows Installation:

  1. Run the installer (.exe)
  2. Follow the installation wizard
  3. Launch “ProPresenter Lyrics” from your Start menu

First Run:

  1. Open the app
  2. Enter your ProPresenter host and port
  3. Click “Connect & Load Playlists”
  4. Browse your playlists and export!

💻 CLI Executables (Advanced Users)

Lightweight standalone binaries for power users and automation.

Download:

macOS Setup:

# Make executable
chmod +x propresenter-lyrics-macos-x64

# Test connection
./propresenter-lyrics-macos-x64 status

Windows Setup:

# Test connection
propresenter-lyrics-win-x64.exe status

Environment Variables (Optional):

# macOS/Linux
export PROPRESENTER_HOST=192.168.1.100
export PROPRESENTER_PORT=1025

# Windows (PowerShell)
$env:PROPRESENTER_HOST='192.168.1.100'
$env:PROPRESENTER_PORT='1025'

🌐 Web Proxy App (Remote Access)

A menu bar app that lets remote users access ProPresenter Lyrics Export from any browser, anywhere in the world — secured with Google OAuth and Cloudflare Tunnel.

Download:

macOS Installation:

# 1. Unzip
unzip ProPresenter-WebProxy-vX.Y.Z-mac.zip

# 2. Fix Gatekeeper (one-time)
xattr -cr "ProPresenter Web Proxy.app"

# 3. Move to Applications
mv "ProPresenter Web Proxy.app" /Applications/

# 4. Launch — appears in menu bar (no dock icon)
open "/Applications/ProPresenter Web Proxy.app"

First Run:

  1. Click the broadcast icon in the menu bar → Settings…
  2. Enter your ProPresenter host (127.0.0.1) and port (1025)
  3. Optionally configure Google OAuth and Cloudflare Tunnel URL
  4. Click Save, then Start Server

See the full Web Proxy Guide for Google OAuth setup, Cloudflare Tunnel configuration, and troubleshooting.

📺 Live Viewer App (Congregation Devices)

A separate companion app that streams live slides to phones, tablets, and laptops on your network.

Download:

macOS Installation:

# 1. Unzip
unzip ProPresenter-Viewer-1.0.0-mac.zip

# 2. Fix Gatekeeper (one-time)
xattr -cr "ProPresenter Viewer.app"

# 3. Move to Applications
mv "ProPresenter Viewer.app" /Applications/

# 4. Launch — appears in menu bar (no dock icon)
open "/Applications/ProPresenter Viewer.app"

Windows Installation:

  1. Run the installer (.exe)
  2. Launch “ProPresenter Viewer” from the Start menu
  3. The app appears in the system tray (bottom-right)

First Run:

  1. Configure ProPresenter host and port in the settings window
  2. Click Test Connection to verify
  3. Click Save — the viewer URL is displayed
  4. Share the URL with your congregation (or display a QR code)

See the full Viewer Guide for detailed setup and usage.

Next Steps

Start Exporting Lyrics

Advanced Features (Optional)

Need Help?

Troubleshooting Setup

Connection refused?

App won’t launch?

Still stuck?

What’s Next?