phonemizer

Phonemizer.js

Simple text to phones converter using eSpeak NG.

Basic usage

import { phonemize } from "phonemizer";

const phonemes = await phonemize("Hello world.");
console.log(phonemes); // ['həlˈəʊ wˈɜːld']

Alternatively, you can load the library from a CDN as follows:

<script type="module">
  import { phonemize } from "https://cdn.jsdelivr.net/npm/phonemizer";

  const phonemes = await phonemize("Hello world.");
  console.log(phonemes); // ['həlˈəʊ wˈɜːld']
</script>

const { phonemize } = require("phonemizer");

(async () => {
  const phonemes = await phonemize("Hello world.");
  console.log(phonemes); // ['həlˈəʊ wˈɜːld']
})();

CommonJS usage

Advanced Usage

• List supported voices

  import { list_voices } from "phonemizer";
  console.dir(await list_voices(), { depth: null });
  

  Example output

  [
    {
      name: "English (Caribbean)",
      identifier: "gmw/en-029",
      languages: [
        { priority: 5, name: "en-029" },
        { priority: 10, name: "en" },
      ],
    },
    {
      name: "English (Great Britain)",
      identifier: "gmw/en",
      languages: [
        { priority: 2, name: "en-gb" },
        { priority: 2, name: "en" },
      ],
    },
    {
      name: "English (Scotland)",
      identifier: "gmw/en-GB-scotland",
      languages: [
        { priority: 5, name: "en-gb-scotland" },
        { priority: 4, name: "en" },
      ],
    },
    {
      name: "English (Lancaster)",
      identifier: "gmw/en-GB-x-gbclan",
      languages: [
        { priority: 5, name: "en-gb-x-gbclan" },
        { priority: 3, name: "en-gb" },
        { priority: 5, name: "en" },
      ],
    },
    {
      name: "English (West Midlands)",
      identifier: "gmw/en-GB-x-gbcwmd",
      languages: [
        { priority: 5, name: "en-gb-x-gbcwmd" },
        { priority: 9, name: "en-gb" },
        { priority: 9, name: "en" },
      ],
    },
    {
      name: "English (Received Pronunciation)",
      identifier: "gmw/en-GB-x-rp",
      languages: [
        { priority: 5, name: "en-gb-x-rp" },
        { priority: 4, name: "en-gb" },
        { priority: 5, name: "en" },
      ],
    },
    {
      name: "English (America)",
      identifier: "gmw/en-US",
      languages: [
        { priority: 2, name: "en-us" },
        { priority: 3, name: "en" },
      ],
    },
    {
      name: "English (America, New York City)",
      identifier: "gmw/en-US-nyc",
      languages: [{ priority: 5, name: "en-us-nyc" }],
    },
  ];
  

• Select different language/voice

  import { phonemize } from "phonemizer";
  
  const phonemes = await phonemize("Hello world.", "en-gb-scotland");
  console.log(phonemes); // [ 'həlˈoː wˈʌɹld' ]