haswello / win-audio

Get, Set and Watch Speaker/Microphone Volume on Windows

win-audio

Get, Set and Watch Speaker/Microphone Volume on Windows

Install

npm i --save win-audio

Requirements

node-gyp to build src/audio.cc

Module

 var win = require('win-audio');

 // manage speaker volume
 var speaker = win.speaker;

 // manage mic volume
 var microphone = win.mic;

Usage

var audio = require('win-audio').speaker;

audio.polling(200);

audio.events.on('change', (volume) => {
  console.log("old %d%% -> new %d%%", volume.old, volume.new);
});

audio.events.on('toggle', (status) => {
  console.log("muted: %s -> %s", status.old, status.new);
});

audio.set(40);

audio.increase(20);

audio.decrease(10);

audio.mute();

Breaking changes version 1.0.1 -> 1.1.0

• EventEmitter is now audio.events
• toggleMute is now toggle
• all functions should be called on "speaker" or "mic" object

Functions

polling(interval)

• Number interval: milliseconds for check volume changes. (Default 500)

get()

Return current percentage of volume.

set(value)

Set a new master volume.

• Number value: percentage of new volume. [0-100]

increase(value)

Increase current volume of value %.

• Number value: percentage. [0-100]

decrease(value)

Decrease current volume of value %.

• Number value: percentage. [0-100]

mute()

Mute volume.

unmute()

Unmute volume.

toggle()

Mute/Unmute volume according to current status.

Events

change

Called when volume is changed.

toggle

Called when volume is muted/unmuted.

Author

Francesco Cannizzaro