Repository navigation
Getting Started
KHost Cue is a personal, on-device karaoke wishlist and set list for tonight. This page covers what it is, how to install it, what happens the first time you open it, and a quick first run through the app.
- Your list, on your phone. Keep songs you want to sing, track how each performance went, and build a set for tonight.
- No account, no login. There's nothing to sign up for. If more than one person sings from the same phone, each of them gets their own list as a separate Singer — switching is a tap on the header avatar, no password involved.
- Nothing leaves the device. KHost Cue doesn't talk to a server, and it doesn't connect to a venue's karaoke system — it's your own private songbook.
| Platform | How |
|---|---|
| Android | Download the .apk from GitHub Releases and sideload it (open the downloaded file; you may need to allow installs from your browser or file manager). |
| iOS | No signed build yet — you build it from source. See Building & testing (you'll need a Mac). |
Once installed, the app checks for a newer release on its own and shows a banner when one's out. You can turn that off in Settings.
A default singer is waiting for you. The app opens with a singer named Me already set up — nothing to name or configure. If more people sing from this phone, add them from the Singers page whenever you're ready.
A guided tour walks you through the app. It runs once, automatically, using sample songs and a sample venue rather than your own data — nothing real is touched, and the samples disappear again the moment the tour ends. It goes chapter by chapter (My Songs, Song Details, Tonight, Venues, Singers, Import & Export, Settings), one card at a time, and skips any chapter for a feature you don't have turned on.
- Skip a single card, skip the rest of a chapter, or skip the whole tour — all at any point.
- It won't run again on its own once you finish or skip it.
- Replay it whenever you like from Settings → Help → "Replay the tutorial" (tap Replay).
Every time you open the app, Settings → App → "Launch Tab" decides where you start:
| Setting | What happens |
|---|---|
| Smart (default) | Opens on Tonight if you already have songs queued for tonight; otherwise opens on My Songs. |
| My Songs | Always opens on My Songs. |
| Tonight | Always opens on Tonight. |
This only decides the very first screen — once you're in, tapping either tab in the bottom bar always takes you there.
- Add a song. On My Songs, tap the + button and type a title and artist.
- Let it fill itself in. Leave year and genre blank — the app looks them up for you in the background, no typing needed.
- Queue it for tonight. On the song's card, tap the button tooltipped "Add to tonight" (that's not the 🎤 you'll see next — that one's the Tonight tab itself, in the bottom bar).
- Switch to the Tonight tab. Tap 🎤 Tonight at the bottom of the screen — your song is waiting there.
- Check it off. Once you've sung it, tap ✓ next to it on your Tonight set.
- Rate how it went. Checking a song off asks "How did it go?" — tap a star, or Skip — just log that I sang it. This rating is separate from the song's overall Enjoyment rating; see Ratings & history for how the two combine.
Everything — your songs, ratings, venues and singers — is stored only on this device.
- Updating the app keeps your data. Installing a newer version over the current one leaves everything in place.
- Uninstalling wipes it. Removing the app removes everything with it, with no way to get it back.
If you want a copy that survives an uninstall, or you're moving to a new phone, export your singer profile from Import & export first.
- My Songs — the wishlist: adding, filtering, sorting, favorites, tags.
- Tonight — building and working through tonight's set.
- Singers — sharing one phone across multiple people.
- Venues — tracking the places you sing.
- Ratings & history — how ratings work and where the star on a song comes from.
- Metadata & album art — how auto-fill and cover art work.
- Import & export — moving a singer between devices, backups, playlist import.
- Settings reference — every toggle, and what it does.
- FAQ & troubleshooting — if something isn't behaving.