A command executable exe, that processes AudioSwitcher scripting files. The scripting files are plain old Javascript files, but have support from the automatically available AudioSwitcher Scripting library.

The scripting library provides a limited set of functionality allowing Javascript to interact directly with any and all of the available Windows Audio Devices. This could be Speakers, Headphones, Microphones, Digital Outputs etc...

To run and execute a macro script use the following, where inputFile.js is the macro.

ascli.exe inputFile.js

To test/debug any scripts you are creating use the --debug switch. This will result in your Windows System Device being UNAFFECTED by the script. It runs the functions in a "sandbox"

ascli.exe --debug inputFile.js

By default when you execute a Javascript file using the Scripting Library it exposes three libraries.

Libraries:

• AudioSwitcher
• Core
• console

This exposes functionality similar to that seen in the Firebug Console. It allows the developer to debug their macro script by printing text to the output window.

log
debug
info
warn
error
assert
group
groupEnd
time
timeEnd

See the Firebug Console API for more details.

Exposes a set of functions that may be useful in scripting. All function are contained within the "Core" namespace.

Exposes the low level functions for interacting with the Audio Switcher API, and therefore control Windows Sound Devices. All functions are contained within the "AudioSwitcher" namespace.

Anywhere that the type "flags" is references it refers to the type of the device:

• Output - 1 - E.g "Speakers"
• Input - 2 - E.g "Microphone"
• All - 0 - There are certain situations where you can pass 0 to get ALL devices Input/Output

Sample macro script that demonstrates the usage of some scripting functions.

//Gets all OUTPUT devices (see the flags arg)
var devices = AudioSwitcher.getAudioDevices(1);

var defaultDevice;

//Prints out all OUTPUT devices to console and finds the current default device
for (var i = 0; i < devices.length; i++) {
    console.log(devices[i].id + " - " + devices[i].name + " - " + devices[i].flags);
    console.log("    Is Default: " + devices[i].isDefault);
    console.log("    Is Default Communications: " + devices[i].isDefaultComm);

    if (devices[i].isDefault) {
        defaultDevice = devices[i];
    }
}

if (defaultDevice !== undefined) {

    //Gets the volume of the current default device
    var vol = defaultDevice.volume();

    //Sets the default device
    defaultDevice.setAsDefaultDevice();
    defaultDevice.setAsDefaultCommDevice();

    console.log("Current Volume: " + vol);
    console.log("Set Volume To: " + defaultDevice.volume(10));
    Core.sleep(2000);
    console.log("Set Volume To: " + defaultDevice.volume(vol));
    Core.sleep(2000);
    console.log("Setting Mute to false");
    defaultDevice.mute(false);
    Core.sleep(2000);
    console.log("Toggling Mute");
    console.log("Is Muted: " + defaultDevice.toggleMute())
    Core.sleep(2000);
    console.log("Toggling Mute");
    console.log("Is Muted: " + defaultDevice.toggleMute());
    Core.sleep(2000);
}