Skip to content

Open-source worship lyrics presenter for macOS, Windows, and Linux.

License

Notifications You must be signed in to change notification settings

jaycho1214/openworship

Repository files navigation

OpenWorship

OpenWorship

Free, open-source worship presentation software for churches

Release License Platform

한국어


Support this project — OpenWorship is free and open-source. If it has blessed your ministry, consider supporting continued development.

GitHub Sponsors Buy Me a Coffee


OpenWorship Preview

Download


Features

Dual-Window System Control from your laptop while displaying on the projector. Real-time preview shows exactly what your congregation sees.
Smart Library Build your permanent song collection. Search, organize, and drag songs into any session instantly.
OCR Import Extract lyrics from images automatically using AI. No more manual typing from song sheets.
Video Backgrounds Beautiful motion backgrounds included. Add your own videos for a professional worship atmosphere.
Custom Typography Import any font. Fine-tune size, weight, shadow, and positioning to match your church's style.
Keyboard Shortcuts Navigate with arrow keys, blank with B, and control everything without touching the mouse.

Quick Start

1. Create a Session    →  Your setlist for the service
2. Add Songs           →  From library, manual entry, or OCR import
3. Open Projection     →  Display on your projector/screen
4. Use arrow keys      →  Navigate through slides

Installation

Platform File
macOS .dmg
Windows .exe
Linux .AppImage

Download

Build from source
git clone https://github.com/jaycho1214/openworship.git
cd openworship
npm install
npm start

User Guide

Sessions

A session is your worship setlist. Create one for each service.

Action How
Create session Click "New Session" in header
Switch session Use dropdown in header
Rename session Right-click session name
Delete session Right-click → Delete

Sessions save automatically.

Adding Songs

Manual Entry

  1. Click "+ Add"
  2. Type title and lyrics
  3. Save

Format your lyrics with blank lines to create new slides:

First verse line one
First verse line two

Second verse line one
Second verse line two

From Library

  • Open library sidebar (left edge)
  • Search for songs
  • Drag into your session

OCR Import

  1. Click "+ Add""Image Import"
  2. Drop files or click to select
  3. AI extracts the lyrics
  4. Review, edit, save

Requires OpenAI API key in Settings → API

Keyboard Controls

Key Action
Previous / Next slide
Previous / Next slide
Page Up Page Down Previous / Next song
Home End First / Last slide
B Blank screen
V Toggle verse indicator
Esc Close projection

Customization

Fonts — Settings → Appearance. Supports .ttf .otf .woff .woff2

Video Backgrounds — Settings → Display. Supports .mp4 .webm .mov

Text Styling — Adjust font size, weight, shadow, position, and line height.


Tips

Preparing for Sunday
  1. Create session early in the week
  2. Add songs in worship order
  3. Review slide breaks
  4. Test on actual display
  5. Ready before service starts
Optimal Slides
  • 2-4 lines per slide
  • Match natural song phrases
  • Avoid single-line slides (too fast)
  • Avoid 6+ lines (too crowded)
Multi-Monitor Setup
  1. Connect projector as extended display
  2. Open OpenWorship on main monitor
  3. Click "Open Projection"
  4. Projection goes to secondary display
  5. Control from main, display on projector

Development

Command Description
npm start Development mode
npm run build Production build
npm run package Create installer
npm run lint Lint code
Architecture
src/
├── main/              # Electron main process
├── renderer/          # React UI (control + projection windows)
└── shared/            # Shared types

Tech Stack — Electron 35 · React 19 · TypeScript 5.8 · Tailwind CSS 4 · shadcn/ui · better-sqlite3 · OpenAI API


Contributing

Contributions welcome! Fork, create a feature branch, and submit a Pull Request.

License

MIT License — free to use for your church or ministry.



"Let everything that has breath praise the Lord."
Psalm 150:6

Made with faith for churches worldwide

About

Open-source worship lyrics presenter for macOS, Windows, and Linux.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages