> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livehub.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Guess the Song

> Name the track from a clip that grows one step at a time

<Info>**Category:** Trivia · **Players:** free-for-all · **Status:** Stable</Info>

A Heardle-style audio race. Each round plays a clip that grows in steps — 1s,
then 2s, 4s, 8s, 16s, up to the full 30s. The earlier you name the track, the
more points you score. Only the **title** counts; naming the artist alone won't
win it.

## Gameplay

<Steps>
  <Step title="Listen to the clip">
    The round opens on a one-second snippet. The host (or an auto-timer) extends
    it a step at a time as the room struggles.
  </Step>

  <Step title="Name the track">
    Type the song title in chat — no command. Guess whenever you like; the first
    correct guess wins the round.
  </Step>

  <Step title="Score by how early you called it">
    Your points depend on the step you guessed at: a one-second call is worth
    the most, the full 30-second reveal the least.
  </Step>
</Steps>

## How the reveal works

Each round is a staircase: the clip only gets longer, and the points on offer
only get smaller — so it rewards the quick ear.

<Frame caption="The clip grows 1 → 2 → 4 → 8 → 16 → 30s; calling it earlier scores more">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/rxLM0Xvl5AlVtm-w/images/games/song-staircase.svg?fit=max&auto=format&n=rxLM0Xvl5AlVtm-w&q=85&s=0b449f8c3e5d9c6e74cb890d179d9856" alt="Six ascending steps of clip length with descending point values from six down to one" width="860" height="254" data-path="images/games/song-staircase.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/rxLM0Xvl5AlVtm-w/images/games/song-staircase-dark.svg?fit=max&auto=format&n=rxLM0Xvl5AlVtm-w&q=85&s=681f36f9adaa27fce2738ba353f01e20" alt="Six ascending steps of clip length with descending point values from six down to one" width="860" height="254" data-path="images/games/song-staircase-dark.svg" />
</Frame>

* **Six steps, six point tiers.** A win scores **6** on the 1-second clip, then
  **5, 4, 3, 2, 1** as the clip extends to 2, 4, 8, 16, and 30 seconds.
* **Title only.** The acceptance check matches the track title (plus common
  variants) — the artist name alone doesn't win.
* **Any win beats no win.** Even a call on the final 30-second clip banks a
  point, so it's always worth guessing.

## Configuration

| Option              | Values                            | Default       |
| ------------------- | --------------------------------- | ------------- |
| **Title-hint gift** | a gift that reveals title letters | Off until set |

The reveal staircase (clip lengths and point tiers) is fixed. The only host
option is the optional title-hint gift below.

**Title-hint gift.** Off until the host picks a gift. When set, sending it
uncovers letters of the song title for the whole room (see [Gifts](#gifts)).

## Layout

<Frame caption="Guess the Song — play surface">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/vMXRdNH3i0sK6lNA/images/games/guess-the-song.svg?fit=max&auto=format&n=vMXRdNH3i0sK6lNA&q=85&s=d72e09367e64f5cc9e22c0cff479376d" alt="Labeled layout of the Guess the Song play surface" width="860" height="436" data-path="images/games/guess-the-song.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/vMXRdNH3i0sK6lNA/images/games/guess-the-song-dark.svg?fit=max&auto=format&n=vMXRdNH3i0sK6lNA&q=85&s=914939c6ad891fe609dfd2c18ccdaf92" alt="Labeled layout of the Guess the Song play surface" width="860" height="436" data-path="images/games/guess-the-song-dark.svg" />
</Frame>

1. **Marquee** — game title and how-to hint.
2. **Round + step meter** — round number and which reveal step the clip is on.
3. **Record** — the now-playing hero; artwork stays hidden until the round ends (it often spells the title).
4. **Title skeleton** — the title as blanks, with any gift-revealed letters filled in.
5. **Leaderboard** — players ranked by total points.

The game moves through **Lobby → Round → Revealed → Finished**.

## Gifts

Guess the Song's gift is a cooperative **title hint** — it uncovers letters of
the title for the whole room. It's off unless the host sets it.

<Frame caption="Each gift uncovers letters of the title at random positions">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/WZDLPJOAmyxnINsO/images/games/chatexto-gift-reveal.svg?fit=max&auto=format&n=WZDLPJOAmyxnINsO&q=85&s=73d562c2ddaba6480e328246814b18fc" alt="Letter tiles filling in as gifts are sent" width="860" height="260" data-path="images/games/chatexto-gift-reveal.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/WZDLPJOAmyxnINsO/images/games/chatexto-gift-reveal-dark.svg?fit=max&auto=format&n=WZDLPJOAmyxnINsO&q=85&s=c62d643b9a4c8b56730eec8d4a46be74" alt="Letter tiles filling in as gifts are sent" width="860" height="260" data-path="images/games/chatexto-gift-reveal-dark.svg" />
</Frame>

* Sending the configured gift reveals letters of the title at random positions,
  helping everyone converge.
* It's a hint, not a solve — the round is still won by the first correct guess.

## Scoring

* Points are awarded by reveal step: **6 → 1** from the shortest clip to the
  longest.
* The highest total across the set wins; ties are shipped as co-winners.
* Points also feed the per-streamer win tally behind
  [avatar ring tiers](/games/leaderboards). Wins are tracked per streamer.