Sound Manager TS

Quick Start

Install

$ npm install sound-manager-ts

import { SoundManager, SoundEventsEnum, SoundEvent } from "sound-manager-ts";

const sm: SoundManager = new SoundManager();

sm.addEventListener(SoundEventsEnum.LOADED, (event: SoundEvent) => {
  console.log("Loaded:", event.soundId);
});

await sm.loadSounds([{ id: "click", url: "/sounds/click.mp3" }]);
sm.play("click");

import { SoundManager, SoundEventsEnum } from "sound-manager-ts";

const sm = new SoundManager();

sm.addEventListener(SoundEventsEnum.LOADED, (event) => {
  console.log("Loaded:", event.soundId);
});

await sm.loadSounds([{ id: "click", url: "/sounds/click.mp3" }]);
sm.play("click");

<!-- ES Module (TypeScript / modern JS) -->
<script type="module">
  import { SoundManager, SoundEventsEnum } from
    "https://cdn.jsdelivr.net/npm/sound-manager-ts/dist/sound-manager-ts.es.js";

  const sm = new SoundManager();
  await sm.loadSounds([{ id: "click", url: "/sounds/click.mp3" }]);
  sm.play("click");
</script>

<!-- UMD (plain JavaScript / browser script tag) -->
<script src="https://cdn.jsdelivr.net/npm/sound-manager-ts/dist/sound-manager-ts.umd.js"></script>
<script>
  const { SoundManager, SoundEventsEnum } = SoundManagerTS;
  const sm = new SoundManager();
  sm.loadSounds([{ id: "click", url: "/sounds/click.mp3" }])
    .then(() => sm.play("click"));
</script>

General Demo

Load sounds, control volume, use sprites, adjust panning, and explore all SoundManager features in one interactive demo.

Open Demo

Multichannels Demo

Organize sounds into named groups and control multiple audio channels simultaneously with group-level volume, play, and stop controls.

Open Demo

Sound Groups Demo

Group sounds with shared instance limits. See maxInstances enforcement live: when the cap is hit, the oldest instance stops automatically to make room for the new one.

Open Demo

Sound Sprites Demo

Split a single audio file into multiple named sprite regions. Play jump, power-up, victory, and other game sounds from one MP3 using start-time and duration tuples.

Open Demo

3D Spatial Audio Demo

Test your surround sound speaker setup. Position audio in 3D space front, back, left, right ideal for TV and home theatre configurations.

Open Demo

Documentation API Reference

Full API reference, configuration options, event types, and usage examples for all SoundManager features.

View Docs

npm Package

Install sound-manager-ts via npm and integrate advanced audio control into your TypeScript or JavaScript project.

View on npm

README & Guide

Getting started guide, installation instructions, configuration reference, and complete code examples to get up and running fast.

Read Guide