Skip to content
Michael Riddle edited this page Jul 29, 2026 · 4 revisions

KHost Cue

You're on cue. KHost Cue is a singer/patron companion app for KHost — a personal karaoke wishlist, an on-deck set list for tonight, and a performance history, all kept on your device.

It runs on iOS and Android, is built with .NET 10 MAUI Blazor Hybrid, and is entirely local: no account, no login, no server of its own.

Start here

If you want to… Read
Install it and take the tour Getting started
Keep a list of songs you want to sing My Songs
Line up a set for the night Tonight
Share the app with the whole table Singers
Track the places you sing Venues
Understand the stars and the history Ratings & history
Let the app pick for you Surprise me
Look up lyrics and jump to YouTube/Spotify/KaraFun Lyrics & quick links
Move a list on or off the device Import & export
Know why a lookup did what it did Metadata & album art
Change how anything behaves Settings reference
Know what leaves the device Privacy, permissions & network use
Read the privacy commitment itself Privacy policy
Fix something that's gone wrong FAQ & troubleshooting

Building on it

Topic Page
How the app is put together Architecture
Where data lives and how stores work Data storage
Razor components, JS interop, theming UI components
iTunes, Deezer, LRCLIB, Spotify, YouTube Music, GitHub External services
Clone → build → deploy → test Building & testing
House style and the PR checklist Coding conventions & contributing

What it does

  • My Songs — a wishlist of songs to sing, as searchable, filterable, swipeable cards with album-art covers.
  • Tonight — an on-deck set for the venue on its own tab: reorder by drag, check each song off as you sing it.
  • Singers — several people share one device, each with their own songs and set; the app re-tints to whoever's up.
  • Venues — the places you sing, optionally auto-detected by location, each building its own history and go-to songs.
  • Ratings & history — a "how it went" score per performance plus a separate enjoyment rating, with a confidence-weighted star that doesn't let one lucky night outrank a solid streak.
  • Lyrics — looked up from LRCLIB and cached on device.
  • Auto-fill — release year, genre and cover art from iTunes, with Deezer as a cover-art fallback, plus a spelling check when a title is one slip off.
  • Import & export — a whole singer profile, your venues, or songs pulled from a public Spotify or YouTube Music playlist.
  • Everything is optional — every extra behaviour has a switch in Settings, and every default reproduces how the app already behaved.

License

PolyForm Shield 1.0.0 — use, modify and self-host freely, including commercially; a competing hosted or rebranded offering needs a separate license. Bundled third-party components are listed in THIRD-PARTY-NOTICES.md.

Clone this wiki locally