Skip to main content

Role terms

ContraDB cards use role words such as ladles and gentlespoons. Callers use many vocabularies. Caller Karaoke replaces recognised role words in both the dance card and the rendered calls.

Open the setting​

  1. Select the gear button in the top-right corner of the header to open Preferences.

    The Preferences screen with Submit feedback and Check for updates in the top-right corner beside the title, the Calling, Band & Sound, Playback, Appearance, Data & Storage, and About categories in a left column, and the Calling settings, starting with Role terms, beside them.
    The gear opens Preferences; categories keep settings in one place, feedback and update checks sit in the header, and playback changes apply without restarting.
  2. Find the Role terms section. The current preset is selected; the italic example below it updates as you change terms.

    The Role terms section with the Larks / Robins preset selected (presets read left side first) and the live role-replacement example below it.
    Presets name the left side first; Larks / Robins is the default and the example updates as the terms change.

Choose a preset​

The presets are:

  • Larks / Robins — the default.
  • Larks / Ravens
  • Gentlemen / Ladies
  • Men / Women
  • Leads / Follows
  • Lefts / Rights
  • Custom

A gent (or man) is the lark-side dancer, and a lady (or woman) is the robin-side dancer: the lark finishes a swing on the left and the robin on the right. That is why the traditional-term presets are named gent first.

Every label names the left-side term first, then the right-side term (Larks / Robins), so the list reads the same way even when a dance card writes its pair in the other order.

Selecting a named preset replaces all four role fields: left singular, left plural, right singular, and right plural. Custom keeps the current words so you can edit them.

Enter custom terms​

  1. Choose Custom, then edit Left singular, Left plural, Right singular, and Right plural.

    The Role terms section with the Custom preset selected and Left singular, Left plural, Right singular, and Right plural fields.
    Custom terms replace role words in both the card and the calls.

Typing in any of the four fields keeps Custom selected; the preset does not snap back to a named one, even if the words happen to match it. The example line updates as you type. The dance card and calls are rebuilt when you leave the field, so a long word does not rebuild the timeline on every keystroke. The selection and terms are saved, so they are still there after a restart.

Use the plural forms for collective phrases (larks allemande) and the singular forms for individual phrases (swing your lark). The example line shows how a mixed card phrase is rewritten.

Where replacement applies​

Replacement is word-boundary based and applies to recognised role words, including:

  • lark side (left): gentlespoons / gentlemen / gents / larks / leads / lefts / men / guys / beaus;
  • robin side (right): ladles / ladies / robins / ravens / follows / rights / women / gals / belles.

It deliberately does not replace shadow, neighbor, or partner; those are not role-side terms. It also does not turn circle left into circle rights, because plain left and right direction words are only replaced when they appear as plural role terms (lefts, rights).

See the result in the session​

  1. Return to Session. The card and the call prompt use the new terms.

    The session screen with a dance card and call prompt using the chosen role terms instead of ladles and gentlespoons.
    Role terms are applied to the card and to the rendered calls.

Role changes rebuild the call timeline, because the rendered words feed the lead calculation. If the session had music loaded, it is marked pending; press Play to render again.

If a term is not replaced​

The classifier only knows role words it can recognise. A custom move phrase that embeds a role word in an unusual form may need a custom alias instead of a role preset. Custom aliases are rendered through the same role replacement, so use the normal role words in the alias template.

Next: Dance move aliases.