Official release repository for LyricDisplay — a professional real‑time lyric display app for live events, church services, and broadcasts.
Maintained by: Peter Alakembi
- Latest release: https://github.com/PeterAlaks/lyric-display-updates/releases/latest
- All releases: https://github.com/PeterAlaks/lyric-display-updates/releases
- Main app repo: https://github.com/PeterAlaks/lyric-display-app
Grab the installer for your platform from the Latest release page:
- Windows –
.exe - macOS –
.dmg(Coming soon) - Linux –
.AppImage(or other artefacts provided per release) (Coming soon)
Builds are packaged for one‑click install. No CLI required.
- Download the installer for your OS from the Latest release.
- Run the installer and launch LyricDisplay.
- Auto‑updates: the app checks this releases repo for updates and will prompt you to install when a new version is available.
Uninstall / reinstall: Installing a newer version over an existing one is supported; your settings are preserved.
Once installed, you can start using LyricDisplay right away.
- After installation, open LyricDisplay from your desktop or applications folder.
- The control panel will appear where you can load lyrics and configure outputs.
- In OBS or VMix, add a Browser Source input.
- For Output 1, set the URL to
http://localhost:4000/#/output1. - For Output 2, set the URL to
http://localhost:4000/#/output2. - Set the width and height of the browser source to match your video canvas (e.g. 1920 x 1080).
- Enable Shutdown source when not visible for performance and Refresh browser when active for reliability.
If you want to capture outputs from another PC on the same LAN:
Note: Identify Your Router’s Gateway (Important) Routers don’t always use the same address — some use 192.168.0.1, others 192.168.1.1, 192.168.8.1, etc. You need to confirm yours before setting a static IP.
To find it: Press Win + R then type: cmd, and press Enter Type: ipconfig Look for the line labelled “Default Gateway” — this is your router’s IP (for example 192.168.0.1 or 192.168.1.1). Use that exact address in the next step as your Default Gateway.
-
Assign a static IP to the machine running LyricDisplay:
-
Windows:
- Open Control Panel → Network & Internet → Network and Sharing Center → Change adapter settings.
- Right‑click your active adapter → Properties → select Internet Protocol Version 4 (TCP/IPv4) → Properties.
- Choose Use the following IP address and assign a fixed address (e.g.
192.168.1.100).
-
macOS:
- Go to System Preferences → Network.
- Select your active interface (Wi‑Fi or Ethernet) → Advanced → TCP/IP.
- Set Configure IPv4 to Manually and enter a static address (e.g.
192.168.1.101).
-
-
On the OBS/VMix machine, add a Browser Source with the following URLs:
http://<Static-IP>:4000/#/output1http://<Static-IP>:4000/#/output2
Replace
<Static-IP>with the fixed IP you configured.
- Use File → Load Lyrics File (or
Ctrl/Cmd + O). - Drag and drop
.txtfiles directly into the app. - Create a new song from scratch with File → New Song (
Ctrl/Cmd + N). - Click on the globe icon button at the top of the left sidebar and search for song lyrics on the search bar aggregated from integrated online providers
- Configure Output 1 and Output 2 independently in the settings panel.
- Preview outputs with
Ctrl/Cmd + 1orCtrl/Cmd + 2. - Toggle the Display Output switch to show or hide lyrics on screen.
- Click any lyric line to send it instantly to the output windows.
- Use the search bar to quickly find a song or line.
- Navigate results with Shift + Up/Down.
- Refresh or resync outputs if styling changes don’t appear immediately.
This guide will help you import your song library from EasyWorship into LyricDisplay. The import process converts your EasyWorship songs into plain text files that work seamlessly with LyricDisplay.
- Click here to read the full guide. It's super easy and all done inside the LyricDisplay app!
For a step-by-step demonstration, click on the video below to watch the included guide (Opens in Google Drive):
This video walks through launching the app, loading lyrics, etc.
- Dual independent outputs with transparent backgrounds (ideal for OBS/VMIX browser sources)
- Advanced lyric management with grouped translations and live editing
- Comprehensive styling (fonts, colours, shadows, margins, themes)
- Cross‑platform with keyboard‑driven workflow and dark mode
Full feature list and user guide live in the main app repo docs.
- Windows: 10 or 11 (64‑bit)
- macOS: 12 Monterey or newer (Apple Silicon & Intel)
- Linux: Modern 64‑bit distro with glibc ≥ 2.28
- Hardware: 8 GB RAM, dual‑display capable GPU for output windows
- Output windows not showing in OBS/VMIX: Refresh/reload the Browser Source; ensure the app is running on the same machine or reachable host.
- No updates found: Check your internet connection; confirm you’re running a release build (not a local dev build).
- Styling not applying: Use the in‑app "Sync Outputs" control; then refresh your Browser Source in your live software.
See the main app repo for deeper troubleshooting guides and FAQs.
For detailed changes, use the per‑release notes on the Releases page. The high‑level latest:
- Installation or release issues: open an issue in this releases repo.
- Feature requests & development issues: use the main app repo issue tracker.
- To Support the development of this app and keep it open source: - Click here to donate
Contact: Peter Alakembi — https://linktr.ee/peteralaks
LyricDisplay integrates optional online lyrics search features powered by free and publicly available lyrics providers.
All lyrics, metadata, and related content displayed through these services remain the property of their respective copyright holders.
- LRCLIB — Free synced lyrics database with nearly 3 million lyrics. No API key required. Provides both plain and timestamped (LRC format) lyrics.
- ChartLyrics — Free public lyrics API with good coverage of popular songs. No API key required.
- Lyrics.ovh — Free lyrics API (public domain and licensed material) provided for educational and non-commercial use.
- Vagalume — © Vagalume Media Group. Lyrics and artist data are provided through the official Vagalume API.
- Hymnary.org — © Hymnary.org / Christian Classics Ethereal Library (CCEL). Content is provided for educational and liturgical purposes.
- Open Hymnal Project — Public domain hymn texts and music as compiled by the Open Hymnal Project.
Logos and brand marks of the above providers are displayed in LyricDisplay for identification and attribution purposes only.
All trademarks, service marks, and logos are the property of their respective owners.
Their inclusion does not imply endorsement, partnership, or affiliation with LyricDisplay or its developers.
- LyricDisplay does not store, redistribute, or claim ownership of any lyrics obtained through these sources.
- Lyrics are fetched on demand from publicly accessible APIs and displayed solely for personal, church, and non-commercial use.
- If you are a copyright holder and wish to request content removal or modification, please contact the original provider directly.
Disclaimer: LyricDisplay and its developers are not affiliated with or endorsed by any of the above content providers.
This feature is offered “as is” for convenience and educational purposes only.
© 2025 Peter Alakembi. All rights reserved.
Developers Peter Alakembi (Lead Designer & Developer) David Okaliwe (Co‑Developer)
LyricDisplay — Powering worship experiences worldwide.