Repository navigation
Home
Michael Riddle edited this page Jul 29, 2026
·
4 revisions
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.
| 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 |
| 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 |
- 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.
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.