Repository navigation
Lyrics and Quick Links
A song's detail sheet can offer a lyrics viewer plus one-tap searches on YouTube, Spotify, and KaraFun. Each is independently switchable in Settings, and each quietly disappears rather than showing broken when it can't be used.
Tap View Lyrics on a song's detail sheet to open its lyrics in their own sheet. The lookup needs no account and no sign-in — it's a free, keyless lookup by song title and artist.
- A hit shows the lyrics text with a "Lyrics via LRCLIB" credit underneath.
- A miss — no match at all — shows "No lyrics found for this song."
- An instrumental match — found the track, but it has no words — shows "This track is instrumental — no lyrics."
Once looked up, a song's lyrics are cached on the device, so reopening them later doesn't need a connection — even a "no lyrics found" result is cached, so the app won't keep re-asking about a song it already knows has none. Enable Lyrics Caching (Settings → Song Details — "Keep looked-up lyrics so they reopen instantly offline.") controls this; turn it off and every open fetches fresh instead, and nothing is saved.
Clear everything cached from Settings → Danger Zone → Clear lyrics cache (N) — the button shows the live count of cached lookups and empties it in one tap. Nothing is lost for good; songs are looked up again the next time you view them.
The whole feature is behind Enable "Lyrics" Button (Settings → Song Details — "Look a song's lyrics up from LRCLIB and read them in the app."); turn it off and View Lyrics disappears from every song's detail sheet.
Below Edit on a song's detail sheet:
| Button | What it opens | Setting that hides it |
|---|---|---|
| ▶ Find on YouTube | A YouTube search for the song | Enable "Find on YouTube" Button |
| Find on Spotify | A Spotify search for the song | Enable "Find on Spotify" Button |
| 🎙 Find on KaraFun | A search of the active venue's KaraFun catalogue for the song | Enable KaraFun Features |
| More KaraFun options | A menu next to Find on KaraFun (only appears when Tonight is on and the song isn't already queued) offering Add to Tonight & Find — adds the song to tonight's set, then opens the same KaraFun search | Same as Find on KaraFun |
All three open outside the app — in your phone's browser, or a matching installed app (the YouTube or Spotify app, if you have it) — never inside KHost Cue itself. If nothing on the device can handle the link, it doesn't open; there's no error message.
KaraFun search is scoped to a single venue, so Find on KaraFun only appears once the active venue has a KaraFun ID saved on it. There are three ways to set one, all on the venue's edit screen (see Venues):
- Paste a KaraFun venue link into the KaraFun venue ID field.
- Type the ID directly — a bare string of digits.
- Scan the QR code using the camera button next to the field (Android and iOS only — the button doesn't appear on other builds).
| Situation | What happens |
|---|---|
| Reopening lyrics you've already viewed | Works fine, served from the on-device cache (as long as caching hasn't been turned off) |
| Looking up lyrics for a song you haven't viewed before | Fails — the lyrics sheet shows a message instead of text, e.g. "Couldn't reach the lyrics service. Check your connection and try again." |
| Tapping a quick link | The browser or app still opens, but the page itself won't load without a connection — the app has no way to detect or warn about this |
A few other lyrics failures you may see: "Lyrics lookups are rate-limited right now — wait a moment and try again." if too many lookups happen in a short time, or "Lyrics service error (503). Try again later."-style messages (the number is whatever error the lyrics service returned) for other server hiccups.
- My Songs — where the song detail sheet these buttons live on is opened from.
- Venues — setting a venue's KaraFun ID, and the venue's own catalogue-wide search.
- Settings reference — every toggle listed above.