Indian BGM Keyboard Docs

Start here

Quick Start

Choose a Raga, Instrument, and Root Shruti.
Click a script tab or create one with Add Script.
Single-click any saved tune to create a new script from it.
Type keys in Key Script, or play notes from your computer keyboard.
Adjust Pace ms for the gap between notes and Hold ms for note length.
Press Play to hear the selected script.
Add scripts to the Arrangement Timeline and place them like clips in a video editor.

Swaras

Keyboard Basics

The keyboard is arranged so every row starts with Sa. This keeps the layout easy to understand while composing Indian melodies.

Base rows

Q A Z start from Sa in different octaves.

W E R T Y U continue the swara movement on the upper row.

Komal and tivra notes

Use Shift on Re, Ga, Dha, and Ni to reach komal variants.

Use Alt or Option on Ma to reach tivra Ma.

Custom keys

Empty keys can be assigned with Set. Click Set, then press the key whose swara you want to duplicate.

Playback language

Writing Key Scripts

A key script is a text version of your melody. Each token is one note, rest, or timing command. Spaces separate notes.

Pattern	Meaning
`Q W E`	Play Q, then W, then E.
`-`	Add a rest or silence.
`Shift+E`	Play the shifted swara for that key.
`Alt+R`	Play the alternate swara where available.
`G*3`	Repeat G three times.
`A@600/400`	Play A with 600ms pace and 400ms hold.

Example:

P { I I*2 F O I F O I A I I - A@600 I A

For musicians

Western and Swara Notation

The app shows the selected script in three forms: keyboard script, Western notes, and swaras. You can edit Western or swara notation directly, and the app converts it back into playable key script.

Western notes

Use notes like C, Db, F, Ab, and octave marks like Db'.

Swaras

Use S r R g G m M P d D n N. Add ' for higher octave or , for lower octave.

Arrangement

Using the Timeline

The timeline works like a compact video editor. Add script clips, drag them in time, layer them vertically, and play the whole arrangement.

Use the sequence dropdown to switch between arrangements.
New creates a fresh empty timeline while keeping your global scripts available.
Save stores the current timeline layers, clip positions, and sequence name.
Add Active places the selected script onto the timeline.
Drag a clip left or right to change when it starts.
Drag a clip up or down to move it to another layer.
Use - / + zoom to stretch or compress the timeline view.
Use the triangle playhead and scrub bar to jump through the arrangement.
When Canvas is active, Space plays or pauses the timeline.

Layered cue example

Build a Space-Drama Bansuri Cue

This cue uses Kalyani, Bansuri, and root C. Combine one repeating motif with slower support notes, then add each saved tune to the timeline.

Layer	Saved tune	Timing
Main motif	`Orbital Piano 1`	Pace 270, hold 460
Pulse variation	`Orbital Piano 2`	Pace 260, hold 360
Low support	`Orbital Long F`, `Orbital Long G`, `Orbital Long A`	Pace 470, hold 670

Place long support notes on lower tracks and stagger them under the main motif. Keep the Bansuri clear, then add another layer only if the scene needs more emotional weight.

Creative workflow

Create Your Own Music

Pick an emotional goal: sad, devotional, suspense, mass, romantic, or heroic.
Choose a raga that matches the mood. For darker emotion, try Keeravani or Natabhairavi. For bright emotion, try Mohanam or Hamsadhwani.
Find a root shruti that feels close to the scene or reference track.
Start with a short 4 to 8 note motif. Repeat it with small changes.
Use rests. Silence makes sad and suspense cues feel more natural.
Layer a second script with a slower instrument such as Film Strings, Sarangi, or Synth Pad.
Save strong ideas as tunes so you can reload them later.
Record and export when the cue feels ready.