Guess the Song
An audio minigame — players listen to a clip and type the song title, with free retries until they name it.
Guess the Song is one of the five minigame challenge types. Players listen to an audio clip and type the song's title. A correct title completes the challenge automatically; wrong guesses cost nothing, so teams can listen and retry until they get it.
What players experience
The challenge screen shows the clue as usual, then a "Guess the song" panel:
- An audio player with the configured clip.
- When a play duration is set, a note under the player reads
You'll get about {n} seconds — listen carefully! - A Song title text box with the placeholder
What song is this? - If an artist is configured, a line under the box reads
Hint: by {artist}(it disappears once the song is guessed).
The player listens to the clip, types a title, and taps Submit guess.
The app compares the guess against the configured title case- and space-insensitively — "bohemian rhapsody" matches "Bohemian Rhapsody". The comparison is exact otherwise: no partial credit for a close-but-wrong title.
Wrong guesses show Not quite — listen again and try another title. and
the player can immediately guess again — retries are free and unlimited,
and there is no life counter.
A correct guess shows That's it! "{title}" — {artist}. and the app
submits the completion automatically.
If the challenge is opened before an audio clip is configured, players see "This song challenge isn't fully configured yet — no audio clip set." instead of the game.
Play duration is advisory in the current app
The player app tells players about the listening cap up front but does not currently hard-stop playback at the configured duration — the full clip remains playable. If part of the clip gives the answer away, trim the audio file itself rather than relying on the cap.
Scoring & answers
Guess the Song is answerless — the title lives in the minigame config,
not in the challenge's answer field, and there is no Answer Type field in
the editor. The mobile app compares the guess locally and, on a match,
submits the sentinel answer minigame_completed; the server marks the
submission correct if and only if it receives that sentinel.
Points awarded on completion follow the standard challenge formula:
- Base points = the challenge's Points value (default 100), minus the hint deduction if the team used the hint, floored at 0.
- Speed bonuses apply for the first teams to finish, when configured.
- An active Double Down artifact effect doubles the whole award.
The outcome is client-trusted
The title comparison happens on the player's device, so the server trusts the win signal from the app — the same pattern as every minigame.
Configuring in the admin
In the challenge editor, set Type to Guess the Song. A Minigame Setup section appears with the config panel on the left and a Live preview on the right, so you can hear the clip and test titles before saving.
| Field | Constraints | Default | What it does |
|---|---|---|---|
| Audio URL | Valid URL, required | — | The clip players hear. |
| Song title | 1–200 characters, required | — | The accepted answer. Matched case- and space-insensitively, but otherwise exactly. |
| Artist | 1–200 characters, required | — | Shown to players as Hint: by {artist} under the answer box. |
| Play duration (sec, 0 = full clip) | Whole number, 0–600 seconds | 15 | Intended listening cap; 0 means the whole clip. Currently surfaced to players as guidance rather than enforced — see the callout above. |
Invalid config blocks publishing
You can save a Guess the Song challenge without a config and fill it in
later, but the event cannot be published or started while any minigame
challenge has a missing or invalid configuration — the readiness check
invalid-minigame-config fails with "N minigame challenges have a missing
or invalid minigame configuration." See
Creating & Configuring Events.
Tips
- The title must match exactly (minus case and spacing). "Bohemian Rhapsody (Remastered 2011)" will never be guessed — configure the plain, well-known title, without parentheticals, featured artists, or punctuation quirks players won't type.
- The artist is a visible hint, not a secret. It displays under the answer box before any guess. If naming the artist gives the song away, consider whether this should be a harder challenge type instead.
- Host the audio somewhere reliable. The clip streams from the URL you provide; a dead or slow link makes the challenge unplayable in the field. Upload through the platform's media tooling rather than hotlinking.
- Mind music licensing. Use clips you have the rights to play at your event — original recordings, licensed tracks, or covers you own.