Song Library

Song Library

Visit the in-app Song Library to browse, search, and filter all available charts.

Quick start

• Open the Song Library and start typing to search by title, tag, or author.
• Use language chips (EN, TR, AR, SP, etc.) to choose translation display language.
• Click a result (or highlight it with the arrow keys) and press Enter to open the song.
• Keyboard navigation works across the list: use the Up/Down arrows to move the active row and Enter to open it.

Filters

• Selecting multiple tags uses ANY matching—songs appear if they include any of the tags you pick.
• Song language preference is saved in localStorage (pref:songLanguage) and reused in SongView, Setlist, Songbook, Worship Mode, and Home suggestions.

Translation behavior

Translation grouping is not yet wired to the Supabase catalog: every song currently appears as its own English entry, so language chips do not show. The rules below describe how the UI behaves once songs are grouped.

• Language chips appear only when at least one translation exists in that language.
• Songs are grouped by translation song_id.
• If a translation exists in the selected language, the card title uses that translated title.
• Clicking a card opens that selected-language variant directly.
• Search checks all known variants in the group (alternate titles/tags/authors), then shows the best display variant for the selected language.
• Result ordering is:
  • songs with selected-language translation (A→Z)
  • songs without selected-language translation (A→Z)
• A divider labeled No Translation in Selected Language appears above fallback songs.

Deep Search

Deep Search: Turn on the Lyrics contain toggle when you need to scan full lyrics, not just titles, tags, or authors. This issues an extra network request, so expect more data use and a brief delay, but it also expands your results to include songs where the lyrics contain your query.