roccomuso/node-aplay

:musical_note: ALSA aplay wrapper for Node.js

aplay

ALSA aplay wrapper for Node.js. It provides basic audio capabilities.

aplay works on:

1. any Debian/Ubuntu system providing ALSA support has been installed.
2. MAC OSX (comes with afplay by default)

ALSA stands for Advanced Linux Sound Architecture. It is a suite of hardware drivers, libraries and utilities which provide audio and MIDI functionality for the Linux operating system.

aplay is a simple native ALSA wav player (to reproduce .mp3 see mpg321).

Installation

Debian/Ubuntu/Raspbian

Get ready. Before we start the real work, please update the system.

sudo apt-get update
sudo apt-get upgrade

If you are running on Raspberry Pi, please update Raspbian

sudo rpi-update

Install ALSA for audio playback

sudo apt-get install alsa-base alsa-utils

USB Audio on Raspberry Pi

If you are planning on using a USB audio on Raspberry Pi you will need to set your USB audio device as the default device.

Edit /etc/modprobe.d/alsa-base.conf and replaced the line:

options snd-usb-audio index=-2

With the following lines:

options snd-usb-audio index=0 nrpacks=1
options snd-bcm2835 index=-2

After a reboot of your Raspberry Pi

aplay -l

Should output the following:

**** List of PLAYBACK Hardware Devices ****
card 0: XXXX [XXXX], device 0: USB Audio [USB Audio]
Subdevices: 1/1
Subdevice #0: subdevice #0

Your device volume will be set to 0 by default. Use the ALSA mixer to adjust the volume using your arrow keys:

alsamixer

Example Usage

Get it through npm:

$ npm install aplay --save

and then:

var Sound = require('aplay');

// fire and forget:
new Sound().play('/path/to/the/file/filename.wav');

// with ability to pause/resume:
var music = new Sound();
music.play('/path/to/the/file/filename.wav');

setTimeout(function () {
	music.pause(); // pause the music after five seconds
}, 5000);

setTimeout(function () {
  music.resume(); // and resume it two seconds after pausing
}, 7000);

// you can also listen for various callbacks:
music.on('complete', function () {
  console.log('Done with playback!');
});

Options

The constructor accepts a config object where you can provide:

• channel: specify a channel.

CLI Usage

$ node node_modules/aplay my-song.wav

It's simple as that.

node-aplay's Issues

standardize code

• standardize code.
• add standard badge.

Property "stopped" remains false after the sound ended.

Property stopped remains false after the sound ended.
It is expected true when checking whether the sound ended.

Inserting
self.stopped = true
in
this.process.on('exit', ...)
solves this problem.

node-aplay/node-aplay.js

Line 35 in 65cdb09

this.process.on('exit', function (code, sig) {

Loop

How do i specify audio should loop?

Select.a different device

Hey i want to know if it is possible to select a different device and pipe audio into that

Can i play a second audio in a different channel?

Hi guys,

I have the necessity to play a second or third audio. Can i do that in different channels?

Thanks!

Audio through 3.5mm Jack instead of HDMI

Hi there, first of all thank you for the library!

I'm playing a audio file with node-aplay. My Pi has an HDMI cable connection and speakers on the 3.5mm jack. The problem is that the audio from node-aplay will be played through HDMI and i would like to play the audio over the 3.5mm headphone jack. The HDMI should only display the RaspberryPi on a Screen but not the audio form node-aplay.

Do you by any chance know how to achieve this? I already configured the Pi to only play audio through the jack with amixer cset numid=3 1, but i assume that ALSA is somehow overwriting this config because as soon as i connect a HDMI cable the audio will be played through that.

I'm using resin.io by the way.

Thank you!

Pipe all sound or specific application sound to stdout?

Hi

thanks for you code. I have a question on the capabilities. I would like to pipe all system sound or at least the sound of one application (spotify - librespot) to stdout so I can pick it up and send it via Airplay to my speakers.

Do you see any possibility to do that with your module?

Thanks and cheers