What it is
A dedicated home for songs, separate from the presentation software. Lyrics with any number of translations, ChordPro-style chord charts with a live preview, and lead sheets rendered as real music notation — with different arrangements per instrument, so the guitarist and the pianist can each see their own version of the same song.
When a song is ready, send it to WorshipHub's library and it is available in the service builder.
Installing
Songs ships as a desktop app for macOS and Windows, and as a web app. The desktop build can discover other computers on the network and sync libraries between them; the web build covers everything else.
Connecting it to WorshipHub
- 1Open Songs and go to its connection settings.
- 2On desktop, WorshipHub on the same network is usually found automatically. On the web, scan WorshipHub's QR code instead.
- 3Request the connection. An Allow / Deny prompt appears on the WorshipHub computer.
- 4The operator taps Allow. After that you can send the whole library, or a hand-picked selection, whenever you want.
Sending is one-way by design: pushing songs into WorshipHub never pulls its library back over yours, so a send can never overwrite work.
If something goes wrong
Chord charts look wrong after import
The editor expects chords in ChordPro-style brackets above the lyric line. Pasting from a site that uses a different layout usually needs a quick pass in the editor — the live preview shows exactly what will be stored.
The other computer does not show up in Local Sync
Discovery uses mDNS on the local network. A browser tab cannot be discovered at all — that is a browser limitation, not a bug — so a web build registers itself with the desktop instead and the desktop pushes to it.
Songs sent to WorshipHub are duplicated
Songs are matched by title. If the same song exists under two slightly different titles, they are treated as two songs. Align the titles and re-send.
macOS says the app "is damaged and can't be opened"
The app isn't damaged, and nothing is wrong with your download. macOS shows this exact wording for any app that isn't signed with a paid Apple Developer certificate — including perfectly healthy ones. See the FAQ for the full explanation of why we don't have that certificate yet.
- 1.Move the app to your Applications folder first.
- 2.Right-click (or Control-click) the app icon and choose Open — do not double-click it.
- 3.A dialog appears with an Open button. Click it. This only happens once per install.
If right-click → Open still refuses, macOS has quarantined the file. Open Terminal and run:
xattr -cr "/Applications/WorshipHub Songs.app"That command removes the quarantine flag macOS attaches to anything downloaded from the internet. It changes nothing else about the app.
See the FAQWorks together with
These apps are commonly used alongside this one during the same service.
Setting up WorshipHub itself
Every companion app talks to the WorshipHub desktop app. If that is not set up yet, start with the main guide.
Release history
What each version of this app can actually do.
v1.2.1
Local sync and discovery fix
- —Fixed peer discovery over mDNS/UDP when VPN tunnels (Tailscale, tun/utun) are active by binding directly to broadcast-capable physical network interfaces.
v1.2.0
Service queue
- —New Service screen to build and reorder queues of songs before sending to WorshipHub.
- —Persistent local queue between sessions with quick calendar toggles on song cards.
- —Drag-and-drop reordering with HTML5 drag on web and pointer events on desktop.
Slide preview and language overrides
- —Slides preview screen allowing independent language selection per queued song.
- —Custom per-slide text overrides resolved dynamically at send time.
Profile identity and updates
- —User profile settings with display name and custom avatar transmitted during pairing.
- —In-app desktop update notifications with live download and installation progress.
v1.1.2
Mobile polish and card accents
- —iOS mobile web container-level safe-area padding and viewport zooming lock.
- —Song cards cycle through tri-color accents for easy visual scanning.
v1.1.0
Visual redesign and chord editor
- —Liquid glass UI redesign with mint green (#6edab4) primary theme and bento settings.
- —Interactive visual guitar chord chart picker with real fingering diagrams.
- —Dedicated desktop chord sidebar and ChordPro autocomplete.
- —Multi-song tabbed editing in top navigation.
- —Full localization across 9 languages via react-i18next.
v1.0.0
Song library and chords
- —Create, edit, and delete songs with title, artist, language, and lyrics.
- —Full-text search across title, artist, and lyrics.
- —Multi-select for bulk actions and sending to WorshipHub.
- —ChordPro-style chord editor with live slide rendering preview.
- —Multiple lyric translations per song and online lyric lookup.
Sync
- —Approval-gated pairing and batch song transmission to WorshipHub.
- —Automatic peer discovery between desktop instances on the local network.