ProPresenter Lyrics Export

Logo

Extract and export worship song lyrics from ProPresenter 7

View the Project on GitHub adamswbrown/propresenterlyricexport

User Guide

← Back to Home Getting Started

Complete guide to exporting lyrics from ProPresenter playlists.

Table of Contents

  1. What This Tool Does
  2. Desktop App Guide
  3. CLI Guide
  4. Need Help?

What Does This Tool Do?

ProPresenter Lyrics Export extracts song lyrics from your ProPresenter presentations and exports them to:

Common use cases:

Watch It in Action

See the song lyrics export feature demonstrated in this quick video:

Desktop App Guide

Before You Start

⚠️ ProPresenter MUST be configured first!

If you haven’t already, you need to enable ProPresenter’s Network API. See the Getting Started guide for detailed instructions.

Quick checklist:

First Launch

  1. Connect to ProPresenter
    • Enter your ProPresenter host (e.g., 127.0.0.1)
    • Enter your ProPresenter port (default: 1025)
    • Click “Connect & Load Playlists”
    • The app will detect your ProPresenter version and load all playlists
  2. Select a Playlist
    • Browse the playlist tree (all folders are expanded by default)
    • Search for playlists using the search box
    • Click a playlist name to select it
    • The breadcrumb path shows your selection

Main Screen - Lyric Export

Library Filter

What it does: Only exports songs from a specific library (e.g., “Worship”).

PPTX Export Settings

Open the ⚙ Settings button to customize your PowerPoint exports:

Basic Options

Text Styling

Export Process (Lyrics Export)

What happens during export:

  1. The tool fetches all presentations from your selected playlist
  2. For each presentation, it extracts lyrics from the slides
  3. Lyrics are organized by section (Verse 1, Chorus, Bridge, etc.)
  4. A PowerPoint file is generated with formatted slides for each song
  5. The file is saved to your chosen location

Steps to export:

  1. Select a playlist from the tree
  2. Set library filter (optional) - Only export songs from “Worship” library
  3. Adjust PPTX settings if needed (fonts, colors, logo)
  4. Click “Export to PowerPoint”
  5. Choose save location and filename
  6. Processing begins (progress shown in log below)
  7. File is saved when complete

What you get: A PowerPoint file with:

Log View: Shows real-time export progress and any issues encountered.

Nested Playlists

The app automatically expands all nested playlist folders so you can easily see and select playlists at any depth. You can collapse folders by clicking the arrow (▸) if you prefer a condensed view.

Need Help?

Basic Commands

Check Connection

propresenter-lyrics status

Shows ProPresenter version and current presentation info.

List Playlists

propresenter-lyrics playlists

Display all playlists with their UUIDs and paths.

List Libraries

propresenter-lyrics libraries

Show all available libraries in ProPresenter.

Get Current Presentation

propresenter-lyrics current

Show details of the currently active presentation.

Get Focused Presentation

propresenter-lyrics focused

Show the presentation with focus in ProPresenter.

Export Commands

Interactive Export (Text)

propresenter-lyrics export

Select a playlist interactively, then export all lyrics as text.

Direct mode:

propresenter-lyrics export <playlist-uuid>

JSON output:

propresenter-lyrics export --json
propresenter-lyrics export <playlist-uuid> --json

Export to PowerPoint

propresenter-lyrics pptx

Interactive mode - select playlist and output filename.

Direct mode:

propresenter-lyrics pptx <playlist-uuid> output-filename

Watch for Changes

propresenter-lyrics watch

Monitor presentation in real-time and display changes as they happen.

Options

Add these flags to any command:

--host, -h <host>      ProPresenter host (default: 127.0.0.1)
--port, -p <port>      ProPresenter port (default: 1025)
--json, -j             Output as JSON instead of text
--debug, -d            Show raw API responses
--help                 Show command help

Examples

# Check connection to remote ProPresenter
propresenter-lyrics status --host 192.168.1.100 --port 61166

# Export specific playlist to JSON
propresenter-lyrics export abc123-def456 --json

# Export PowerPoint with custom host
propresenter-lyrics pptx --host 192.168.1.100 my-service-pptx

# Watch live with debug output
propresenter-lyrics watch --debug

Environment Variables

Avoid typing host/port every time:

export PROPRESENTER_HOST=192.168.1.100
export PROPRESENTER_PORT=1025
propresenter-lyrics status  # Uses env vars

Connection Settings

Finding Your Host and Port

Local Machine:

Remote Machine:

How to Find ProPresenter Settings

  1. Open ProPresenter 7
  2. Go to Preferences → Network
  3. Look for:
    • Enable Network API checkbox (must be enabled)
    • Port field (note this number)
    • Host IP (if remote, find this on the ProPresenter computer)

Network Firewall

If connecting to a remote ProPresenter:

Troubleshooting

Connection Issues

“Connection refused” or “Network error”

  1. Verify ProPresenter is running
  2. Check Network API is enabled (Preferences → Network)
  3. Verify host and port are correct
  4. Try from the ProPresenter computer first (use 127.0.0.1)

“Connection timed out”

  1. Check firewall rules
  2. Verify the ProPresenter IP address is correct
  3. Ensure the port is open
  4. Try status command with --debug flag for more info

Export Issues

PowerPoint file is empty or has missing lyrics

  1. Verify the playlist contains presentations
  2. Check that the library filter matches your songs
  3. Try with no library filter (leave blank) to see all items

Font not appearing in exported PPTX

  1. Ensure the font is installed on the system where PPTX will be opened
  2. Use a system font (Arial, Helvetica, etc.) for guaranteed compatibility
  3. Check the font dropdown to see installation status

macOS Issues

“App is damaged and can’t be opened”

xattr -cr "/path/to/ProPresenter Lyrics.app"

App won’t launch

Windows Issues

“Windows protected your PC”

  1. Click “More info”
  2. Click “Run anyway”
  3. Grant administrator permissions if prompted

Command not recognized

Tips & Tricks

Batch Processing

Use the CLI to automate exports:

#!/bin/bash
for uuid in abc123 def456 ghi789; do
  propresenter-lyrics pptx "$uuid" "output-$uuid"
done

Custom Font Setup

  1. Download fonts from Google Fonts
  2. Install on your system
  3. Use the font dropdown in settings
  4. Click “Refresh” after installation

PPTX Styling

Remote ProPresenter

For a computer on your network:

  1. Find its IP (Windows: ipconfig, macOS: ifconfig)
  2. Enable Network API on that computer
  3. Connect from another machine using that IP and port
  4. Ensure network allows the connection