This library allows developers to access audio visualisation data from the Windows using Node.js, providing a simple API to access this data. It is written in Rust and utilizes napi-rs to implement bindings with Node.js.
English | 简体中文
node-windows-audio-visualisation only supports Windows.
- Access to the Windows audio visualisation data.
- Support for both JavaScript and TypeScript.
- Easy to use and integrate into existing Node.js applications.
npm i @coooookies/windows-audio-visualisationCommonJS Example
ESModule Example
TypeScript Example
// Typescript & ESModule
import { AudioMonitor, getDefaultOutputDevice, getAllOutputDevices } from '@coooookies/windows-audio-visualisation';
// CommonJS
const { AudioMonitor, getDefaultOutputDevice, getAllOutputDevices } = require('@coooookies/windows-audio-visualisation');Gets all output devices on the system.
const devices = getAllOutputDevices(); // AudioDevice[]
// [
// {
// id: "{0.0.0.00000000}.{00000000-0000-0000-0000-000000000000}",
// name: "Speakers (Realtek High Definition Audio)",
// isDefault: true
// },
// {
// ...
// }
// ]Gets the default output device on the system.
const device = getDefaultOutputDevice(); // AudioDevice | null
// {
// id: "{0.0.0.00000000}.{00000000-0000-0000-0000-000000000000}",
// name: "Speakers (Realtek High Definition Audio)",
// isDefault: true
// },Get the spectrum data, the spectrum data is composed of an array, the length of the array is the number of spectra, and each element in the array represents the loudness of the spectrum unit, with a value range of 0 to 1.
const audio = new AudioMonitor()
audio.setDevice("{0.0.0.00000000}.{00000000-0000-0000-0000-000000000000}") // Set the device id
audio.start(2048) // start monitoring with 2048 chunk size
// audio.stop() // stop monitoring
const bands = 8 // Number of bands
const spectrum = audio.getSpectrum(bands)
// [0.521, 0.821, 0.123, 0.456, 0.789, 0.234, 0.567, 0.890, ...]
setInterval(() => {
console.log(audio.getSpectrum(bands))
}, 1e3 / 20)
// [0.521, 0.821, 0.123, 0.456, 0.789, 0.234, 0.567, 0.890, ...]
// [0.123, 0.456, 0.789, 0.234, 0.567, 0.890, 0.123, 0.456, ...]
// [0.789, 0.234, 0.567, 0.890, 0.123, 0.456, 0.789, 0.234, ...]
// ...This project is licensed under the MIT License.