Skip to main content

Session controls

The Session tab is the practice screen. The top row holds the tabs; the session controls below hold the tempo, transport, loop, count-in, speech, and volume settings.

Transport and tempo​

ControlRange / defaultNotes
Tempo200–300 BPM by default; the session range is configurable in Preferences → Playback, and the full range is 120–320A dance beat is half a bar. At 240 BPM one beat is 0.5 s and a 64-beat dance is 32 s. A tempo outside the configured window stays selectable.
Play/Pause—One button that shows the action it offers: the play symbol renders pending music and starts or resumes, and the pause symbol stops the music and any speech, keeping the position.
Restart—Returns to the count-in and clears the call state.
End tune—Slows the tune's last bar, holds the final chord, then stops.
Loopon by defaultRepeats the 64-beat music loop.
Cycle tunesoff by defaultPlays through a set of saved tunes, changing at a repeat.
Count-inon by defaultFour accompaniment beats built from the tune's first chord.
Speak callsoff by defaultSpeaks the active call with the neural voice, or the system voice as a fallback.
Caller0–1.5, default 1.0Level of the spoken calls, independent of the band.
Band0–1.5, default 0.8Master level of the music mix.
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.

The tempo slider uses a 200–300 BPM window by default. Preferences → Playback → Tempo range sets a different minimum and maximum inside the 120–320 BPM limits, with Reset to 200–300 to restore the default. A tempo outside the window is not snapped: the slider widens just enough to keep the current value selectable.

Changing tempo, count-in, an instrument row, a player count, a row's volume or direction, the band list, the output mode, a percussion rhythm, an accompaniment rhythm, a SoundFont, or Humanize timing marks the music for a rebuild. Playback settings apply without restarting the music: release the control and the app prepares the new loop in the background, keeps the current beat, and installs the new loop when it is ready. The old loop keeps playing in the meantime. The session Caller and Band levels apply immediately. If the session is not playing, it shows:

Press Play to prepare the music with these settings.

Press Play to install the prepared loop and start. If preparation has not finished, the status reads Preparing music… and playback starts when it is ready. The web build has no render worker and prepares the loop on the press. Role, alias, and lead changes rebuild the call timeline without re-rendering the music.

Undo and Redo (Ctrl+Z and Ctrl+Y) put a setting or a dance/tune choice back. A running session keeps its beat when only playback settings changed: the loop is re-rendered and playback resumes where it was. Undoing a dance or tune selection stops the old music and speech and leaves the restored tune ready for the next Play, exactly as choosing it from a picker would.

Background playback​

Minimizing the window, covering it, or switching to another app leaves the audio alone: the music keeps playing and the spoken calls keep coming on the same beats. Only the drawing stops.

The transport follows the audio position, not the frame rate, so the caller stays in time whether or not a frame is painted. Pausing is the only thing that stops it. On desktop, the keyboard's play/pause media key still works while the window is in the background. On Android, the headset, lock-screen, and notification controls keep working while the activity is in front or paused; the app does not run a foreground service, so a session that Android stops in the background stops with it.

Keyboard​

  • Space plays or pauses.
  • R restarts from the count-in.
  • Esc returns from a download screen to its saved-content list, from the alias editor to Preferences, and from a picker or Preferences to the session. On a phone it first steps out of a Preferences category to the category list. The Android system back button does the same.
  • 1-4 switch between Session, Select dance, Select tune, and the dance glossary; 5 opens Preferences from any screen, like the gear button in the header.
  • ← / → switch to the previous or next tab, wrapping at the ends.
  • Enter starts a search from a search field, creates a folder, or adds a custom alias.
  • Ctrl+Z undoes the last preference or dance/tune change; Ctrl+Y or Ctrl+Shift+Z redoes it. The same actions are buttons in Preferences → Appearance.

Shortcuts are ignored while a text field has focus, and the arrow keys are left to a focused slider or list. On desktop, the keyboard's play/pause media key controls the transport even when the window is in the background; on Android, the headset, lock-screen, and notification controls do the same while the app is running. See Keyboard shortcuts.

The call prompt​

The large panel at the top of the session, directly under the tab row, is the karaoke prompt. It moves through these states:

StateDisplayWhat to do
ReadyREADY, Press Play to beginPress Play to start the prepared music.
Count-inCOUNT-IN, a large number, and either CALL NOW or Listen for the first chordWait for the loop, or say the first call if it is already due.
CallingCALL NOW, green cardSay the words now. The detail line counts down to the execute beat, and the NEXT: footer previews the following call.
ExecutingUPCOMING MOVE, red card, the next call, and call in N beatsThe figure is happening; prepare to say the next call. The dance card still highlights the figure in progress.
FinishedDance completePress Restart to run again. End tune also finishes here.

While a figure executes, the prompt switches to the move you must say next. The call that follows it stays inside the same card as a NEXT: footer — it is part of the prompt, not a separate line under it. The card therefore keeps one height while the session runs, so switching between CALL NOW, UPCOMING MOVE, and the final figure never moves the controls below. The card reserves room for two lines of call text and the footer; a longer call wraps and makes the card taller instead of clipping the words. The idle READY card and the completed card stay content-sized.

The session screen while a figure is being danced, showing the UPCOMING MOVE prompt naming the next call and the beats until it starts.
While dancers execute a figure, the prompt switches to the move the caller must say next.
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.

The executes in N beats line is the remaining lead. A short call may show about two beats; a long call up to six by default once the safety padding (0.5 s by default) is added and the automatic total is rounded up to a whole beat. Both this line and the upcoming-move card's call in N beats countdown round to the nearest half beat and show one decimal (4.0, 3.5). See Timing and lead.

If Show original card text is enabled in Preferences, the original card wording appears in small muted text next to the rendered call.

Count-in and the first call​

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.

The count-in is four dance beats of accompaniment only. At 240 BPM that is 2.0 seconds. Turn Count-in off to start directly on the first figure. The setting applies to the next run when the session is idle, and turning it on while a dance is playing gives the next run a count-in. If you turn it off during a count-in that is already playing, the app lets that count-in finish and changes the timeline and the music together at beat 0, so the dance never restarts in the middle of the count. The first call often starts during the count-in because its lead is subtracted from beat 0. That is intentional: the caller needs to say the first figure before the dancers move on beat 0. When a call is already active during the count-in, the panel shows CALL NOW and the call text instead of Listen for the first chord. With the count-in off, the first call is announced as the run starts, and it is never spoken twice or dropped when the setting changes.

The session screen during the count-in with the first call previewed below Listen for the first chord.
The first call can begin during the count-in because it starts before beat zero.

The tune summary and dance card​

Below the prompt, the tune line shows the tune title, key, rhythm, and every band row with its player count such as Fiddle ×2 when a row has more than one player. The dance card at the bottom of the session shows every figure with its phrase label, its beat count, and the lead for its call in the top-right corner as call 4.0 beats. The active figure row is highlighted as the music moves.

The card uses compact padding by default, so a standard dance fits whole on a desktop session tab without scrolling. Preferences → Appearance → Dance card padding switches to Sparse for the roomier rows the card used before. A longer card still scrolls inside its box, and the setting also spaces the card figures in the saved-dance and download previews.

On a wide window the space below the controls is split into two boxes: the dance information and beat meter on the left, and the dance card on the right. The card scrolls inside its box, so a long card never pushes the prompt or the controls off screen. Phone and tablet widths keep the stacked layout, with the card below the meter.

The Glossary button beside the Dance card heading, or the Glossary tab in the top row, opens the in-app Dance glossary. Many terms in the prompt and on the card are underlined as well; selecting one opens its entry directly. The glossary is a reading aid and does not change the loaded dance or its timing.

The tune and instrument summary below the call prompt, showing the tune title, key, rhythm, melody, accompaniment, countermelody, and percussion with its rhythm, and the copy counts for each part.
The summary confirms what will play before you start.

The progress bar shows the current beat out of the 64-beat loop, and its text names the transport state: Ready, Count-in, Playing, Paused, Ending, or Finished. The state is there because a paused session sounds the same as a muted one. During the count-in the bar stays at zero and the text counts the beats left.

Looping, pausing, and finishing​

  • With Loop on, the 64-beat music repeats from beat 0 and the call sequence restarts with it.
  • With Loop off, the audio stops at the end of the loop and the prompt shows Dance complete.
  • The Play/Pause button stops both audio and TTS while the music runs; the same button resumes from the current position.
  • Restart resets to the count-in, not to the beginning of the card.
The session controls with the Loop checkbox cleared.
With looping off, the dance stops at the end of the 64-beat loop.
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.

Ending the tune​

Select End tune while music is playing (or paused) to finish the way a band would. Four dance beats before the end of the loop the arranger splices into a rendered ending: the accompaniment thins, the tempo eases, the final melody note rings, and the final chord is held for a few seconds before the audio fades out. The final chord and its closing melody note resolve a perfect fifth below the written ones by default. The prompt shows SLOW FINISH while the ending plays, and Dance complete when it is over.

In Preferences → Playback, Gradual ending turns the four-beat reveal off, so only the final bar is replaced and stretched. Resolve the final chord a fifth lower keeps the written chord and melody when it is off.

The ending is prepared with the music, so it starts without a delay. Press Cancel ending before the ending begins to keep playing normally. With Loop off, End tune still plays the slow ending instead of stopping abruptly.

End tune eases the last four beats, thins the band, holds the final chord a fifth below, and then stops.

Cycling tunes​

Contra bands usually stay on one tune for several minutes and change at a repeat. Cycle tunes does the same with your saved tunes:

  1. Open Select tune and add each tune with Add to tune set in the preview, or select a folder and use Use this folder as the tune set.
  2. Turn on Cycle tunes in the session controls.
  3. Set Change tune every to the number of 64-beat times through. The default is eight, about four minutes at 240 BPM; the session line shows the actual time at the current tempo.

The next tune is rendered during the current tune's last time through, so the change is ready at the boundary. The call timeline continues unchanged, and the new tune starts at beat 0 without a second count-in. Cycle tunes needs Loop on, because a non-looping run stops after one pass. The web build has no background renderer, so it prepares the next tune at the change instead.

Cycle tunes changes to the next saved tune at a repeat, using music rendered during the previous pass.

Sharing a session (web)​

The browser build can put the whole setup into the page address. Open Share this session in the session summary and the app copies a link that carries:

  • the dance card: title, choreographer, formation, notes, and every figure with its beats;
  • every tune in the tune set, in order, including its ABC music;
  • how many times through each tune changes, and which tune starts.

The link is self-contained, so a friend needs no download and no data proxy. Opening it adds the cards to their saved libraries, selects the dance, restores the tune set, and starts on the same tune. A shared card with the same source replaces that saved copy, the same way downloading it again does. Their own preferences — role terms, band, volume, and lead timing — are left alone.

Links are compressed but can still be long. The panel keeps the address selectable, so if the browser blocks the automatic copy, select the text and copy it by hand. A damaged or newer-format link leaves the current session in place and shows a short error. A link can hold at most 100 tunes.

Spoken calls​

Enable Speak calls in the session controls or in Preferences. The visual prompt is always shown; speech is optional. The app speaks each active call once, stops speaking when you pause or disable speech, and clears the spoken-call state when you restart or rebuild the timeline.

The session controls with the Speak calls checkbox selected.
Spoken calls accompany the visual prompt; the visual prompt is never hidden.

See Text to speech for availability and rate.

Volume​

The session has two sliders. Caller sets the spoken calls and Band sets the whole music mix. They are independent: a quiet band still lets the caller through, and turning the caller down leaves the music alone. Each band row's own Volume lives in Preferences → Band & Sound, under the shared Band volume master.

The session controls with the Volume slider visible beside the transport buttons.
Master volume is separate from the melody and accompaniment balances in Preferences.

Preferences​

Preferences has six categories: Calling (role terms, lead timing, spoken calls), Band & Sound (the band list, output mode, SoundFont, effects), Playback (loop, count-in, tempo range, variations, human timing), Appearance (theme, motion, dance card padding, shortcuts, undo), Data & Storage (dance-source pointer, web proxy, cache, MIDI export, memory use), and About (version, credits, project links). A desktop shows the category list in a left frame and the selected category's settings beside it. A phone shows the list first and opens one category at a time; the back control, Esc, and the Android system back button return to the category list, and a second Back returns to the session.

Find a setting at the top of Preferences searches every category by setting name, category, or a common synonym. Type volume to see Caller volume, Band volume, each instrument's level, and the dancer-sound level; type bpm to reach Tempo range, or glossary to reach its appearance option. Each match names the category it belongs to. Selecting a match opens that category, scrolls its section into view, and clears the search; Clear search returns to the category layout without leaving Preferences. The search is cleared automatically the next time Preferences opens, so it never hides the categories on a later visit. On a phone the field and results use full-width rows that meet the same 44-pixel touch target as the category list.

Maintenance and memory​

Preferences → Data & Storage has Export MIDI…, Clear source cache, and a Memory use section. The memory table measures the bundled and decoded SoundFont, the rendered music buffer, the prepared rotation buffer, fonts, the sheet-music texture, saved libraries, caches, undo snapshots, and the optional neural voice, and gives a total. Refresh memory use rebuilds the table after a setting or a session changes.

The biggest optional consumers are the neural voice (turn Speak calls off to release it and its prepared deliveries; they reload from the cache when enabled again), the four prepared deliveries per call (set Deliveries per call to 1 to skip them), and the four music variation passes per render (turn Vary the music on each loop off for one pass). Cycling tunes also keeps the next rendered tune in memory. See the memory notes for the measured numbers and the remaining options.

The About text is the About category of Preferences. It shows the program name, its version, a short description, the author (Nicholas Gower), and links to the project website and the source code.

About is one of the Preferences categories, beside the settings list.

It is part of the Preferences screen, so it never covers the session, traps focus, or suspends the transport and tab shortcuts. Press Esc or select Session to leave.

Narrow windows​

At phone width the session tab uses its compact layout. The top row keeps four short tabs — Session, Dance, Tune, and Terms — beside the pinned gear button that opens Preferences, without the wordmark. On a wide window the gear also carries the word Preferences when the header has room; the text is dropped before the wordmark. The tempo, caller, and band sliders span the screen with their value boxes, and Play/Pause, Restart, and End split one row evenly. Loop, cycle tunes, count-in, and spoken calls stay on one wrapping row. Every control keeps a 44-pixel touch target.

When the window is too short to show the prompt, controls, progress, and dance card together, the whole session page scrolls; the prompt stays at the top of that page. On a taller phone the prompt stays put and only the dance card scrolls. The saved-content and download screens use a single scrolling column at phone width, with full-width fields and the preview below the results.

On a touch screen, swipe left or right across empty content to change tabs. A press that starts on a control — a button, slider, folder row, splitter, or open menu — belongs to that control, so dragging from it never changes tabs. A mostly vertical swipe scrolls instead. Sliders are guarded on a touch screen: tap the rail (a padlock and rounded outline mark it) to unlock the level, then drag sideways to change it. The padlock goes away while a slider is unlocked, tapping or swiping anywhere outside it puts the padlock back, and the page does not scroll while you drag an unlocked level. A swipe that starts on a locked slider still scrolls. On a desktop with a touch screen the guard follows the input you used last: touching the screen guards the sliders, and moving or clicking with the mouse releases them again.

The session screen at phone width with one-row tabs, full-width Tempo, Caller, and Band sliders whose rails sit inside rounded outlines with padlocks, Play/Pause, Restart, and End on one row, and a green CALL NOW prompt above the dance card.
The phone layout gives the sliders the full width and every control a 44-pixel touch target; each rail is outlined with a padlock until the slider is tapped.
The session screen in a 390-pixel-wide window with compact tabs, outlined and padlocked Tempo, Caller, and Band sliders, stacked transport controls, the READY prompt, and the dance card below.
The compact layout keeps every session control usable at phone width, with outlined sliders guarded until tapped.

Next: Role terms.