Skip to main content

Your first session

This is the shortest useful path through the app. It uses the bundled defaults first, then shows how to replace them.

Before you start​

  • Launch the installed app, a source build, or the hosted browser copy. See the installation pages or Build and run.
  • Have an audio output device available. In a browser, press Play once to allow audio.
  • The first time you download a dance or tune, the app needs network access to ContraDB and ABC Session Tunes. The bundled defaults do not.

1. Look at the starting screen​

The app opens on Session with Another Last Dance and Sandy Boys loaded. The dance card and tune summary are already populated. The prompt at the top of the session says READY, and the line below the controls says Press Play to prepare the music with these settings.

  1. Start the app and confirm that the dance, tune, and tempo controls are visible. Do not worry that the music has not been rendered yet.

    The session screen immediately after launch, showing READY, Another Last Dance, Sandy Boys, 240 BPM, and the message Press Play to prepare the music with these settings.
    On launch the bundled default dance and tune are ready; press Play to render the music.

The app prepares the arrangement in the background as soon as the session is idle. The first Play installs that prepared loop and starts the count-in; if you press Play before preparation finishes, the status reads Preparing music… and playback starts as soon as the loop is ready.

2. Choose a dance​

Select dance lists the dances saved on this device. The bundled default is already there, and the current dance is not replaced until you choose Use this dance.

  1. Select Select dance in the top tab row. Search saved content, select a card to preview it, and press Use this dance in the preview to load it.

    Select dance lists your saved cards; search them, group them into folders, and load one without a network.
  2. To add another dance, select Download dance. This opens the ContraDB search screen; previewing a result does not save it.

    The Download dance screen with a Dance source menu above Title, Choreographer, User, Hook, Formation, Figure type, Figure contains, Verified only, and Sort fields, above an empty results area.
    Download dance selects its source and searches it, then previews a card before saving it locally.
  3. Type part of a title in Title and select Search dances. The default results are ten per page; use Next and Previous to page.

    The Download dance screen with last typed in the Title field and a list of matching dances on the left, a downloaded badge on saved cards, and a dance preview on the right.
    Results show the title, choreographer, and formation; Preview opens the figures.
  4. Select a result row to preview it, read the figure list and beat total, then select Download dance to keep it or Use this dance to download and load it immediately.

    The Download dance screen with Another Last Dance selected, the Download again, Use this dance, and View saved dances buttons, and its figure list below.
    Download the card for offline use or load it immediately; either action saves it to your library.

You can also filter by Choreographer, User, Hook, Formation, Figure type, or Figure contains, show only Verified only dances, and change Sort. See Choosing a dance for the full search and folder reference.

3. Choose a tune​

Select tune lists the tunes saved on this device. Its search and folder panel work like the dance library.

  1. Select Select tune in the top tab row, then select a saved tune to see its sheet music.

    Select tune lists your saved tunes with an offline sheet-music preview.
  2. Select Download tune to search ABC Session Tunes for another melody.

    The Download tune screen with Search and Composer fields, Key, Meter, and Genre menus, and an empty results area.
    Download tune searches ABC Session Tunes and previews the sheet music.
  3. Search by title or composer, optionally filter by Key, Meter, or Genre, then select a result row to preview it. Download tune saves the tune and Use this tune saves and loads it.

    The Download tune preview showing the tune metadata, credits, source link, Show ABC toggle, Download again and Use this tune buttons, and rendered sheet music.
    The preview engraves the ABC as sheet music; Download saves it and Use loads it.

The preview engraves the ABC as sheet music. Show ABC switches to the source text; edits there are not saved and do not change the tune. The preview also links to the tune on ABC Session Tunes when a source URL is available.

The session screen after choosing Another Last Dance, showing its title and figures in the dance card and the pending-rebuild message.
Using a dance returns to the session and marks the music for a rebuild.

4. Set the tempo​

The default is 240 BPM, which gives a 0.5-second dance beat and a 32-second 64-beat dance. The slider ranges from 120 to 320 BPM.

  1. Move the Tempo slider. On a touch screen, tap the padlocked rail first, then drag sideways. The app shows the prepare-music message when stopped; while playing it prepares the new loop in the background without restarting, keeps the current beat, and installs it when it is ready.

    The session controls with the Tempo slider set to 240 BPM beside one Play/Pause button, Restart, End tune, Loop, Cycle tunes, Count-in, Speak calls, and Volume.
    Tempo changes mark the music for a rebuild; press Play to apply them.

5. Start the session​

  1. Press Play. The music starts with a four-beat count-in built from the tune's first chord. If the first call has already started, the count-in panel shows CALL NOW and the call text.

    The session screen during the count-in, showing a large 2, the label COUNT-IN, and either CALL NOW with the first call or Listen for the first chord.
    The four-beat count-in sets the tempo before the 64-beat loop begins.
  2. Follow the call prompt at the top of the session. It turns green for CALL NOW, then red for UPCOMING MOVE as the figure executes and it previews the next call. The NEXT: footer inside the card previews the call after the one it names, and the card keeps the same height in both states.

    The session screen during a figure, showing the CALL NOW prompt, the executes-in countdown, the NEXT footer naming the following call inside the same card, and the active dance-card row.
    The large prompt is the call to say now; its footer previews the next call, so the panel keeps one height.
  3. Change a setting such as tempo or an instrument. While playing, the new loop is prepared without stopping the old one. When stopped, the prepare-music message returns and the next Play applies it.

    The session screen showing the message Playback settings will apply without restarting; press Play to apply them now, with the current call still visible.
    Playback settings apply without restarting; press Play to apply them immediately.
  4. Press the Play/Pause button while the music runs: it shows the pause symbol and stops the music and any speech. Press it again to resume from the same position.

    The session screen with playback paused, the current musical position retained, and the Play control available.
    Pause stops the music and any speech; Play resumes from the same position.
  5. With Loop off, the dance ends with Dance complete. Press Restart to run it again from the count-in.

    The session screen after the non-looping dance ends, showing the message Dance complete and the instruction to press Restart.
    With looping off, the session stops at the end of the loop.

With Loop on (the default), the 64-beat music loop repeats from beat 0 and the call sequence restarts with it. A card shorter than 64 beats leaves music playing after its last call. A card longer than 64 beats is not fully reached in 0.1.0: the playhead resets at the loop boundary. Prefer cards whose preview total is 64 beats.

Pausing is visible without sound: the progress bar names the transport state, so after pausing it reads Paused · beat 12 / 64 and stays there until the same button resumes from the same beat.

What the call prompt means​

LabelMeaning
READYNothing has started yet. Press Play.
COUNT-INThe four accompaniment beats before beat 0. If a call is already due, the panel shows CALL NOW and its text.
CALL NOWSay the displayed words now; the dancers execute shortly.
UPCOMING MOVEThe figure is executing; the prompt turns red and shows the call to say next.
DANCINGThe figure is executing and there is no following call; the prompt is muted.
Dance completeThe music reached the end with looping off.

The executes in N beats line counts down to the figure's execute beat. It is not a metronome; the music is the clock. The dance card prints each call's lead as call N beats, and both live countdowns — executes in and call in — are rounded to the nearest half beat with one decimal (4.0, 3.5).

If something does not work​

  • No sound: check the audio device. The session shows an Audio device: message when the app had to fall back to silence.
  • The music takes a moment to start: the app prepares the loop in the background. If the first Play arrives before it finishes, the status reads Preparing music… and playback starts when it is ready. There is no separate progress screen in 0.1.0.
  • A search fails: dismiss the red bottom panel with Dismiss and retry. The current dance or tune is not replaced by a failed search.
  • A call starts during the count-in: that is expected. The first call is placed before beat 0 so the words finish before the first figure.

Next: Choosing a dance.