Skip to content

Lyrics and Quick Links

Michael Riddle edited this page Jul 28, 2026 · 3 revisions

Lyrics & 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.

Lyrics

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."

Caching for offline reading

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.

Quick links

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

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):

  1. Paste a KaraFun venue link into the KaraFun venue ID field.
  2. Type the ID directly — a bare string of digits.
  3. Scan the QR code using the camera button next to the field (Android and iOS only — the button doesn't appear on other builds).

Offline

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.

See also

  • 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.

Clone this wiki locally