npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

bellows-voice

v0.7.2

Published

An articulatory singing and speaking voice for bellowsjs: a physical model of a singer, lyrics and text in eight English accents, and text to IPA.

Readme

bellows-voice

A singing and speaking voice for bellows. It is an articulatory synthesizer, a physical model of a singer: lyrics move 17 articulators (jaw, tongue, lips, velum and the rest), their positions become the shape of the throat and mouth, and air from the lungs flows through that shape in a waveguide airway. It sings and speaks English in eight accents, and IPA.

npm install bellowsjs bellows-voice
import { Bellows } from 'bellowsjs';
import { voice, singer } from 'bellows-voice';

const b = await Bellows.boot({ plugins: [voice] });   // from a click handler
const alto = singer(b, { body: 1 });                   // 0 male, 1 female, 2 child

alto.sing('twinkle twinkle little star', [
  { note: 'C4', dur: '4n' }, { note: 'C4', dur: '4n' },
  { note: 'G4', dur: '4n' }, { note: 'G4', dur: '4n' },
  { note: 'A4', dur: '4n' }, { note: 'A4', dur: '4n' },
  { note: 'G4', dur: '2n' },
], { at: b.now() + 0.5 });

alto.speak('Good morning. Where are you from?', { accent: 'australian' });

voice is a bellows plugin: the engine, prebuilt as one script that loads into bellows' AudioWorklet beside its kernel, so a page that never sings never loads it. singer(b, params, opts) makes an instrument on it and gives it sing() and speak(), which reach bellows only through its public API. Notes go through bellows' tempo map and tuning like any other note.

In a single HTML file, from a CDN

bellows-voice imports bellowsjs by name, so a page without a bundler maps that name with an import map. The map is also what makes the page and the voice share one copy of bellows; with two copies, singer() cannot see the plugin and throws.

<script type="importmap">
  { "imports": { "bellowsjs": "https://cdn.jsdelivr.net/npm/[email protected]/dist/bellows.js" } }
</script>
<script type="module">
  import { Bellows } from 'bellowsjs';
  import { voice, singer } from 'https://cdn.jsdelivr.net/npm/[email protected]/dist/index.js';

  document.querySelector('button').onclick = async () => {
    const b = await Bellows.boot({ plugins: [voice] });
    singer(b, { body: 1 }).speak('Hello from a single file.');
  };
</script>
<button>Speak</button>

The other entries load the same way: .../dist/text.js, .../dist/view.js, .../dist/engine.js, .../dist/dict.js. unpkg serves the same files (https://unpkg.com/[email protected]/dist/index.js).

Starter voices

const soprano = singer(b, 'soprano');            // or 'bass', 'baritone', 'tenor', 'contralto', 'mezzo',
const host = singer(b, 'narrator-female');       // 'narrator-male', 'pop-female', 'pop-male', 'child', 'rock', 'elder'
host.speak('Good evening.');                     // at the voice's own speaking pitch

VOICE_PRESETS lists them, each with its group (male, female, child), the engine params, a speaking pitch inside the published range for its group, and the range it sings in. The values come from published norms and from measuring this voice against them; docs/VOICE-NORMS.md has the sources and the measurements.

With Vite

Vite's dev server pre-bundles dependencies, and would fold its own copy of bellowsjs into bellows-voice, which then cannot see the plugin your copy loaded. Keep it out of the pre-bundle:

// vite.config.js
export default { optimizeDeps: { exclude: ['bellows-voice'] } };

Accents

const tenor = singer(b, { body: 0 }, { accent: 'southern-british' });
tenor.sing('the water in the bath was far too hot', melody, { accent: 'scottish' });

Thirty-one are built in, each with a region (ACCENT_REGIONS):

| Region | Accents | |---|---| | North America | general-american (the default), canadian, californian, new-york, boston, inland-north, southern-us | | England | received-pronunciation, southern-british, london, west-country, brummie, scouse, northern-english, geordie | | Scotland, Wales and Ireland | scottish, welsh, irish, northern-irish | | Southern hemisphere | australian, new-zealand, south-african | | Africa | nigerian, ghanaian, kenyan | | Caribbean | jamaican, trinidadian | | Asia | indian, singaporean, filipino | | Europe (English as a second language) | russian |

Each is a broad transcription of the accent's mainstream form, from the published lexical-set tables (sources in src/lyrics/accents.ts), not a recording of any one speaker. An accent is plain data: each of Wells's lexical sets (KIT, BATH, GOAT, NURSE...) voiced as a vowel or a diphthong with its glide timing, whether r after a vowel is said, its t, l, th, r and h rules, consonants it swaps (Russian w as v) and whether it devoices a word's last consonant, vowels raised before voiceless consonants (Canadian "price" and "house"), and a speech melody: the final tune, the pitch range, the rate, and how much longer a stressed syllable is than an unstressed one (about twice in British or American English, nearly the same in the syllable-timed Englishes of India, Nigeria, Singapore and Jamaica). Spread a built-in to make your own:

import { ACCENTS } from 'bellows-voice';
const mine = { ...ACCENTS.irish, id: 'mine', sets: { ...ACCENTS.irish.sets, FACE: 'eɪ' } };

Beatbox

The same tract makes drum sounds the way beatboxers do: an ejective kick (the glottis shut, the larynx rising like a piston behind the lips), pulmonic hats and snares, an inward snare drawn in through the mouth, tongue clicks and lip pops, and a hummed bass. One step a sixteenth; . rests, | marks a bar, > accents, m:43 hums MIDI note 43.

const bb = singer(b, 'beatboxer');   // a close microphone: it hears the air of each kick
bb.beatbox('B . t . | Pf . t . | B B t . | ^K . t tss', { bpm: 96, swing: 0.1, repeat: 4 });

BEAT_PRESETS has eight patterns and VOCAL_BEATS lists every sound with its airstream and a line on how the mouth makes it. Any voice can beatbox; the mic param (0 to 1) sets how close the microphone is, from the far field to a cardioid 2 cm from the lips.

Shaping the mouth

Every voice has settings anyone can turn: long-term postures laid over every sound, and its size.

const v = singer(b, 'narrator-female');
v.shape('operatic');                         // or 'smile', 'pout', 'belt', 'nasal', 'giant', 'tiny' ...
v.shape({ lipRound: -0.8, larynxSet: 0.2 }); // a smile in the voice
v.speak('Hello there.');

VOICE_SETTINGS lists each one with its name, what its two ends sound like, what it does in plain words and in acoustic terms: jaw, lips (smiling to pouting), lip opening, tongue forward and height, voice box (lowered to raised), throat (squeezed to open), twang, nasal, cheeks, head size, throat length and throat pockets. A consonant still closes whatever the setting. SHAPE_PRESETS has ten shapes; describeShape(values) says one in a sentence.

Speech breathes in between phrases (speak(text, { breath: 'between' | 'all' | 'none' })).

The voice explained

import { describeSound, nearestVowel } from 'bellows-voice/text';
describeSound('ʃ');          // 'Made with the front of the tongue just behind the ridge ... As in "ship".'
nearestVowel(730, 1090, 0);  // { ipa: 'ɔ', word: 'hawed' }: the vowel two resonances sound like

Text to IPA, without audio

import { toIPA, pronounce } from 'bellows-voice/text';

toIPA('far away', { accent: 'southern-british' });   // 'fɑɹ ə.ˈweɪ'
pronounce('hello').words[0].sets;                     // [undefined, 'GOAT']

bellows-voice/text is pure TypeScript with no audio and no bellows, for a page, a server or a test.

Drawing the mouth

bellows-voice/view runs the voice's own geometry on its articulator targets, for a UI to draw:

import { TractModel } from 'bellows-voice/view';
const tract = new TractModel(1);          // body
tract.target('i');                        // follow the plan's spans as they play
tract.step(1 / 60);                       // articulators move at the engine's speeds
const { upper, lower, velumPort, lipArea } = tract.shape();   // centimetres, glottis to lips

shape().drawing and headProfile(drawing) give the whole head to draw (tongue, lips, teeth, jaw, soft palate, epiglottis, skin, skull, nasal cavity, larynx); setSettings() shows a voice's settings; mouthHandles(model) and settingsForHandle(model, handle, x, y, ipa) let a person drag the tongue, jaw, lips, soft palate or voice box and get the settings that make that mouth; formants() gives the shape's first three resonances.

target() also takes a beat from a beatbox line's spans ('beat:B'), with the larynx raised for an ejective and the velum down for the hum, and shape().constriction is the narrowest point, where the sound is made.

Rendering

b.render() renders through the worklet with the plugin loaded, exactly as it plays. To render with renderOffline() or in Node without a worklet, register the engine on that thread:

import { renderOffline, registerBuiltins } from 'bellowsjs';
import { registerVoice } from 'bellows-voice/engine';
registerBuiltins();
registerVoice();

Pronunciations

Words go through English letter-to-sound rules (about 77 percent of common words exact) unless you give a pronouncing dictionary. One ships as its own entry, loaded only if you import it (about 570 KB gzipped):

import { cmudict } from 'bellows-voice/dict';
const v = singer(b, 'narrator-female', { dictionary: cmudict() });   // every CMU word as CMU says it

Numbers, symbols and initialisms are said as words ("21st", "$5", "10:05", "TV"). IPA between slashes, /ˈlɪt.əl/, sets the sounds directly.

Content-Security-Policy

The plugin loads through a blob URL, as bellows' kernel does. A host that blocks blob: script sources serves bellows-voice/worklet.js itself and passes { ...voice, workletUrl: '/path/to/worklet.js' }.

Credits

The voice owes a large debt to CHIMERA, Jameson Hodge's physical-model voice synthesizer (MIT): the articulators and their speeds, the gesture planner, the mouth geometry, the airway's physical elements, the glottal source and the lyric front end are ported from it or learned from its code (THIRD_PARTY_NOTICES.md). The waveguide airway, the pitch behaviour, accents, speech and the vowel solver are bellows-voice's own.

Documentation: bellows.live/docs/singing. Design notes: docs/.

MIT License.