Choir Leader Setup Guide

Everything you need to get your choir set up and your singers practising.

Getting Started

Before your members can use the app, you need to do three things:

1
Create a Dropbox folder for your choir

This is where you'll put all your practice tracks. You can name it anything — e.g. My Choir or Amazing Voices.

2
Create a view-only shared link for that folder

Chorustr reads your files but never modifies them. Follow these steps to create a view-only link:

  1. Navigate to the choir folder in Dropbox
  2. Click the Share Folder button
  3. Click Copy Link
  4. By default Dropbox creates an edit link — click Manage
  5. Select Link for viewing
  6. Click Copy Link
3
Email us to register your choir

Send the choir name and your view-only Dropbox link to support@chorustr.com. We'll create your choir entry and reply with a choir code — a short code your members type into the app to join.

This is a one-time step. Once your choir is set up, you manage everything by adding files to the Dropbox folder — no further contact with us is needed.


Folder Structure

The root of your Dropbox shared folder is your choir folder. Create one subfolder per song — that's it. There's no deeper nesting.

My Choir/ ← root of the shared folder ├── Amazing Grace/ ← one subfolder per song ├── Baba Yetu/ └── Proud Mary/

Track Types: Premixed vs Stems

Chorustr supports two ways of providing audio. Choose the one that matches how your tracks were produced.

Option A — Premixed Tracks

Each MP3 is a complete full-mix recording with one voice part louder than the rest. Put the MP3 files directly inside the song folder.

Amazing Grace/ ├── soprano.mp3 ← full mix, soprano loud ├── alto.mp3 ← full mix, alto loud ├── tenor.mp3 ← full mix, tenor loud ├── bass.mp3 ← full mix, bass loud └── full.mp3 ← full mix, all parts equal — REQUIRED

full.mp3 is required for premixed songs. Without it the song will show as "Coming Soon" even if all the other parts are present. full.mp3 is what plays when a member chooses "All Parts" in the mixer.

Option B — Stems Tracks

Each MP3 is a single isolated part with no other voices audible. Put all the MP3 files inside a subfolder named stems. The app mixes them live, and members can adjust the volume of each track independently.

Amazing Grace/ └── stems/ ├── soprano.mp3 ├── alto.mp3 ├── tenor.mp3 └── bass.mp3

The presence of a stems/ subfolder is all that's needed — the app detects it automatically and switches to stems mode. No full.mp3 is required.

Stems take priority. If a stems/ subfolder exists, any MP3 files placed directly in the song folder are ignored. Chorustr always uses stems when they are present.


Supported Filename Keywords

The app identifies each track by looking for a keyword anywhere in the filename. Everything else — song title, dashes, spaces, numbering — is ignored. Filenames are case-insensitive, so Soprano.mp3, SOPRANO.mp3, and soprano.mp3 all work.

Keyword in filename Part Mode
sopranoSoprano (undivided)Both
soprano1  or  soprano 1Soprano 1Both
soprano2  or  soprano 2Soprano 2Both
altoAlto (undivided)Both
alto1  or  alto 1Alto 1Both
alto2  or  alto 2Alto 2Both
tenorTenor (undivided)Both
tenor1  or  tenor 1Tenor 1Both
tenor2  or  tenor 2Tenor 2Both
bassBass (undivided)Both
bass1  or  bass 1Bass 1Both
bass2  or  bass 2Bass 2Both
baritoneBaritoneBoth
womenWomen (combined)Both
menMen (combined)Both
fullFull mix / All PartsPremixed only
backingBacking track (no lead vocals)Stems only
clickClick / metronome trackStems only

Examples of valid filenames: Soprano.mp3, SOPRANO 1.MP3, Alto 1 - Baba Yetu.mp3, Amazing Grace - Bass.mp3.

Any file whose name doesn't contain a recognised keyword is silently ignored.


Supported File Formats

Audio — MP3 only

All audio tracks must be MP3 files (.mp3). Other formats (WAV, AIFF, AAC, FLAC etc.) are not recognised and will be ignored.

Recommended encoding settings:

Lyrics — PDF only

Lyrics files must be named lyrics.pdf and must be in PDF format. Other document formats are not supported.

Song icons — PNG only

Icon files must be named icon.png and must be in PNG format. A square image works best — the app crops to a square if needed.


Minimum Files Required

A song with only one part is perfectly playable — members just won't have other parts to choose from.


Lyrics

Add a PDF named exactly lyrics.pdf to the song folder. It will appear in the Lyrics pane on the now playing screen, so members can follow the words while they listen.

Amazing Grace/ ├── soprano.mp3 ├── ... └── lyrics.pdf

Song Icons

Add an image named exactly icon.png to the song folder. It will be shown as artwork in the song list and the player. If no icon is present, a default placeholder is used.

Amazing Grace/ ├── soprano.mp3 ├── ... └── icon.png

Coming Soon Songs

If you want to add a song to the list before the tracks are ready, create the song subfolder but leave it empty. The app will show the song with a Coming Soon badge so members can see it's on the way.

Once you add audio files to the folder, members will be able to play the song on their next sync.

Premixed reminder: even if all voice part MP3s are present, the song shows as Coming Soon until full.mp3 is added.


Updating Songs

Replace or add files in the Dropbox folder at any time. Chorustr compares file hashes and only re-downloads what has changed, so updates arrive quickly. Members get the update automatically the next time they open the app — no action needed on their part.


Deleting Songs

Delete the song subfolder from Dropbox. On the next sync the app removes it from the playlist and deletes the locally cached files from each member's device.


Questions?

If you get stuck or something isn't working as expected, email us at support@chorustr.com and we'll help you get sorted.