Creating Compositions

Create your own compositions directly in the app — write bols, preview playback, and share with your class or the community.

Starting a new composition

1. Tap My Compositions on the Library tab.
2. Tap + to create a new composition.
3. Fill in the details:
   • Title — the name of your composition.
   • Taal — choose from Teentaal, Jhaptaal, Ektaal, and others.
   • Category — Theka, Kayda, Tukda, Rela, etc.
   • Tempo — default playback speed in BPM.

The editor

The editor is a plain text field where you type bol notation. As you type, a live preview shows how the composition will look on the taal grid.

• Type bols separated by spaces: Dha Dhin Dhin Dha
• Use - for rests (silence): Dha - Dhin -
• Wrap subdivisions in parentheses: (DhaGe) (TiRa)
• See Notation Basics for the full syntax guide.

Live preview

The preview updates as you type, showing:

• The taal grid with proper vibhag alignment
• Any parser errors highlighted in the text
• Row count and bol count

Tips

• Start simple — write the theka first, then add variations below.
• Use ## headers to label sections (Theka, Variation 1, etc.) — these show up in the grid as section dividers.
• Tap Play to hear your composition without leaving the editor.
• Long compositions are easier to manage with variables ($X = ...) and repeats ([pattern] x 4).

Saving and editing

• Compositions save automatically as you edit.
• Return to any composition from My Compositions to continue editing.
• Tap the composition title in the player view, then Edit to jump back to the editor.

Visibility and sharing

New compositions are private by default — only you can see them.

• Private — only you.
• Class — visible to members of a class you own.
• Published — visible to everyone in Browse and shareable via link.

Change visibility from the composition's detail view. See Sharing for more on publishing and share links.

Importing and copying

• Open any published composition and tap Copy to duplicate it into your own library for editing.
• Paste notation from a text message or note directly into the editor.