Native libshout bindings for node.js, forked to use koffi instead of node-ffi. Original here.
Libshout allows applications to easily communicate and broadcast to an Icecast streaming media server. It handles the socket connections, metadata communication, and data streaming for the calling application, and lets developers focus on feature sets instead of implementation details.
More detail: http://icecast.org
Original libshout docs: http://www.aelius.com/njh/libshout-doc/libshout.html (a copy of this page can be also found at /docs/libshout2.html)
I forked it from the original so it uses koffi instead of ffi-napi, since for some reason I couldn't get ffi-napi working. Cited from the original, you'll need a Node.js version with N-API version 8:
Node < 12.22.0 is not supported
Node 12.x: Node 12.22.0 or newer
Node 14.x: Node 14.17.0 or newer
Node 15.x: Node 15.12.0 or newer
Node 16.0.0 or later versions
You have to install the libshout library before using nodeshout-koffi.
| Platform | Package |
|---|---|
| MacOS via brew | libshout |
| Ubuntu | libshout |
| Fedora | libshout-devel |
| Alpine Linux | libshout-dev |
Then, install nodeshout-koffi via npm.
npm i nodeshout-koffi
# or
yarn add nodeshout-koffiInitalize the nodeshout library, create a Shout instance and configure it.
// Initalize
nodeshout.init();
// Create a shout instance
const shout = nodeshout.create();
// Configure it
shout.setHost("localhost");
shout.setPort(8000);
shout.setUser("source");
shout.setPassword("password");
shout.setMount("mount");
shout.setFormat(1); // 0=ogg, 1=mp3
shout.setAudioInfo("bitrate", "192");
shout.setAudioInfo("samplerate", "44100");
shout.setAudioInfo("channels", "2");Open the connection.
shout.open();If connection is successful, above function will return nodeshout.ErrorTypes.SUCCESS which is integer 0. After successful connection, you can send audio file chunks via shout.send method.
shout.send(buffer, bytesRead);For the synchronization, there is 2 method provided. First one is shout.sync() method, this method blocks current thread. Second one is shout.delay() method, this method returns how many milliseconds you should wait to send next audio chunk.
If you're gonna stream multiple files, beware that Icecast requires stable bitrate & sample rate for the whole stream. So all of your music files should have the exact bitrate & sample rate.
Check the /demos folder.
// Create a metadata instance
const metadata = nodeshout.createMetadata();
// Set currently playing song.
metadata.add("song", "Led Zeppelin - I can't quit you baby");
// Apply metadata to shout
shout.setMetadata(metadata);Below is a short guild to the development in this repository
- Clone repository
- Verify that your node version and NPM version are compatible with the repository. NVM is useful here.
- Verify that you have the libshout dependency installed, for Mac OSX you can install with
brew install libshouton a linux distribution like Ubuntu you need to download the source or binary and build it. Typically after building it will install to a directory like/usr/local/lib/libshout - Install dependencies:
yarn install - Start icecast server
- Run
npm testand see it's working
If you get the below error its likely that the libshout dependency is installed incorrectly
Error: ENOENT: no such file or directory, open 'libshout.so'
The install for the libshout dependency on non-mac systems can be a bit annoying. I found it easiest to install it on linux via building from source. https://icecast.org/download/
If you scroll down to the bottom of that page you can get the libshout source download tar.gz link.
After downloading the dependency, follow the INSTALL instructions for installing it locally. The libshout library should be installed to /usr/local/lib/libshout (At least it was on Ubuntu based distributions). This file must be passed into the FFI.Library function. Either you can pass in the fully qualifed path, or make the /usr/local/lib/libshout available to the system to reference without a path name.