# Open Worship — User Documentation

**Open Worship** is free, open-source church presentation software. Use it to display worship song lyrics on projectors and livestreams, manage a song library, and build service schedules—all without subscription fees.

This guide is for **church tech volunteers** and operators who run lyrics during services.

---

## Quick start

1. **Install** the app (see [Getting Started](getting-started.md)).
2. **Add songs** in the **Library** or import from `.txt` files ([Adding Songs](adding-songs.md)).
3. **Build a schedule** in **Schedule** with your setlist ([Building Schedules](building-schedules.md)).
4. **Run the service** from **Presenter**: choose your schedule, advance slides with Space or arrow keys, and press **GO LIVE** when you’re ready ([Running a Service](running-a-service.md)).

Optional: enable **NDI** in Settings to send lyrics into **OBS** for livestreaming ([NDI & OBS Setup](ndi-obs-setup.md)).

---

## Documentation index

| Topic | Description |
|-------|-------------|
| [**Getting Started**](getting-started.md) | System requirements, installation (Windows, Mac, Linux), first launch, and a tour of the interface (Library, Schedule, Presenter, Settings). |
| [**Adding Songs**](adding-songs.md) | Adding songs manually, importing from text files, song format and section markers, editing, deleting, and tags. |
| [**Building Schedules**](building-schedules.md) | Creating a schedule, adding songs and custom items, blank slides, reordering, saving, and loading. |
| [**Running a Service**](running-a-service.md) | GO LIVE, Presenter view, keyboard navigation, multi-display setup, and quick song access during the service. |
| [**NDI & OBS Setup**](ndi-obs-setup.md) | What NDI is, installing NDI Runtime, enabling NDI in Settings, and using Open Worship as an NDI source in OBS (including transparent overlay). |
| [**Keyboard Shortcuts**](keyboard-shortcuts.md) | Full list of shortcuts for navigation, presentation, and quick actions. |
| [**FAQ**](faq.md) | Common questions and troubleshooting tips. |

---

## Main areas of the app

- **Library** — Your song database. Add, edit, search, and tag songs. Import from `.txt` files.
- **Schedule** — Build setlists: add songs, custom text (e.g. scripture, announcements), and blank slides. Reorder and save.
- **Presenter** — Run the service: pick schedule or browse songs, advance slides, and send output to a projector or NDI.
- **Settings** — Display output, NDI, fonts and colors, backgrounds, backup/export, and more.

---

## Need help?

- Check the [FAQ](faq.md) for common issues.
- Report bugs or suggest features on the [GitHub repository](https://github.com/inno8/open-worship).