play.js - play sound files from node.js to your speakers, simple as cake and kid approved!

Installing npm (node package manager)

 curl http://npmjs.org/install.sh | sh

Installing play.js

 npm install play

USAGE

 var play = require('play').Play();
// play with a callback
play.sound('./wavs/sfx/intro.wav', function(){
// these are all "fire and forget", no callback
play.sound('./wavs/sfx/alarm.wav');
play.sound('./wavs/sfx/crinkle.wav');
play.sound('./wavs/sfx/flush.wav');
play.sound('./wavs/sfx/ding.wav');
});
//If you want to know when the player has defintely started playing
play.on('play', function (valid) {
console.log('I just started playing!');
});
play.sound('./wavs/sfx/ding.wav');
//If you want to know if this can't play for some reason
play.on('error', function () {
console.log('I can't play!');
});

CLI DEMO

 cd examples
node demo.js

Web DEMO

Recommended that you use play.min.js for web-based playbacks assumes you have already embedded the audio file as an embed tag

 <embed id = "hat" autostart = "false" src = "./wavs/drums/tick.wav"/>
<embed id = "snare" autostart = "false" src = "./wavs/drums/snare.wav"/>
<embed id = "kick" autostart = "false" src = "./wavs/drums/kick.wav"/>

see examples/index.html

###drum party, now go to JSONloops => http://github.com/marak/JSONloops

Requirements

Node.js

One of the CLI based audio player

• 'afplay'
• 'mplayer'
• 'mpg123'
• 'mpg321'
• 'play'
• (anyother cli based audio player)

If you know that a certain player will exist in the CLI you can actually force it to use that specific player using the usePlayer function (see below for specifics)

Raw Handle to the player and using usePlayer

 // If you want raw access to the player (via stdin)
// require and stuff happened here
var play = require('play').Play();
var player = false;
// Force it to use mplayer (can be anything else)
play.usePlayer('mplayer');
play.on('play', function () {
player = play.player;
});
play.sound('./somelonglongsong.wav');

Notes on using usePlayer

The player better exist or all hell may break lose.