Skip to content

Getting Started

Michael Riddle edited this page Jul 27, 2026 · 2 revisions

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.

What it is — and isn't

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

Installing

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.

First launch

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

Which tab you land on

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.

Your first five minutes

  1. Add a song. On My Songs, tap the + button and type a title and artist.
  2. Let it fill itself in. Leave year and genre blank — the app looks them up for you in the background, no typing needed.
  3. 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).
  4. Switch to the Tonight tab. Tap 🎤 Tonight at the bottom of the screen — your song is waiting there.
  5. Check it off. Once you've sung it, tap ✓ next to it on your Tonight set.
  6. 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.

Where your data lives

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.

Where to go next

Clone this wiki locally