swaralipi-js

A JSON spec, Unicode-Bengali viewer, and Tone.js player for Rabindrasangeet swaralipi (Tagore's আকারমাত্রিক notation). GPL-2.0-only, framework-agnostic.

Live demo →  Spec · Creator · GitHub

pnpm add @ugfoundation/swaralipi-js

Three building blocks

View

import { defineSwaralipiSheet } from '@ugfoundation/swaralipi-js/viewer';
defineSwaralipiSheet();

// <swaralipi-sheet src="/notation/4270.json" lang="bn"></swaralipi-sheet>

Pure SSR renderer too: renderToHtml(doc, { lang }) + SWARALIPI_CSS. Print/PDF via .print().

Play

import { SwaralipiPlayer } from '@ugfoundation/swaralipi-js/player';

const player = new SwaralipiPlayer();      // zero-config: samples from the project CDN
player.load(doc);
player.bindSheet(document.querySelector('swaralipi-sheet')); // highlight sync + tap-to-play
playButton.onclick = () => player.play();  // needs a user gesture (AudioContext)
repeatButton.onclick = () => player.setLoop(player.loop ? null : undefined); // this line
turnButton.onclick = () => player.setEcho(!player.echo); // …and a silent pass to sing it back

Embed

Drop a sheet + player into any page or iframe — the demo builds a copy-paste <iframe> snippet for you against the bare /embed route.

Subpath exports