Un4Seen Bass Audio Library Wrapper

Bass Audio library is the best audio library to play, edit, convert, stream etc. this wrapper wraps most of the "audio playback" features using ffi , ref , ref-struct .

ffi enables to call c library methods, properties , callbacks etc.

Compatible with?

tested on MacosX El capitan, windows 32 and 64 bits, ubuntu 14+, raspberrypi 2-3 (armv7), not tested on armv6 but its easy to test, just install and see.. related platform binaries can be downloaded from bass web page..

Warning

Please put the required bass audio library files to root folder (dll files for windows, so files for *nix, dylib files for macos)

Download the required dll files from http://www.un4seen.com. i did not include the required files in this module..

Read full documentation of bass from its original help. i Will only write same simple examples.

Features:

• BASS_Init

• BASS_GetVersion

• BASS_StreamCreateFile

• BASS_StreamCreateURL

• BASS_StreamFree

• BASS_ChannelPlay

• BASS_ChannelStop

• BASS_ChannelPause

• BASS_ChannelGetPosition

• BASS_ChannelSetPosition

• BASS_ChannelGetLength

• BASS_ChannelBytes2Seconds

• BASS_ChannelSeconds2Bytes

• BASS_ChannelGetLevel

• BASS_ChannelRemoveSync

• BASS_ChannelIsActive

• BASS_ChannelSetAttribute

• BASS_ChannelGetAttribute

• BASS_ChannelSetSync

• BASS_ChannelSlideAttribute

• BASS_ChannelIsSliding

• BASS_ChannelGetDevice

• BASS_ChannelSetDevice

• BASS_StreamFree

• BASS_SetDevice

• BASS_SetVolume

• BASS_Start

• BASS_Stop

• BASS_Pause

• BASS_GetInfo

• BASS_ErrorGetCode

• BASS_Free

• BASS_GetCPU

• BASS_GetDevice

• BASS_GetDeviceInfo

• BASS_ChannelGetTags

• BASS_Mixer_StreamCreate

• BASS_Mixer_StreamAddChannel

• BASS_Mixer_ChannelGetLevel

• BASS_Mixer_ChannelGetMixer

• BASS_Mixer_ChannelGetPosition

• BASS_Mixer_ChannelRemove

• BASS_Mixer_ChannelRemoveSync

• BASS_Mixer_ChannelSetPosition

• BASS_Mixer_ChannelSetSync

• BASS_Encode_Start

• BASS_Encode_IsActive

• BASS_Encode_SetNotify

• BASS_Encode_SetPaused

• BASS_Encode_Stop

• BASS_Encode_CastInit

• BASS_Encode_CastGetStats

• BASS_Encode_CastSetTitle

Extra:

SYNCPROC also implemented

Installation

Install with npm : npm install bassaudio

Examples

basic load and play file

var bass=require('bassaudio'); 
var basslib=new bass();
 
 //get all sound cards
 var cards=basslib.getDevices();
 console.log('total found sound cards:' + cards.length)
 //lets print first sound card's info, find out more inside source code..
 //first item in array '[0]' is "no sound" , then use the item [1]
 //you will see that card isInitialized will be false, because we did not init it yet..
 var card=cards[1];
 console.log(card.name + ' is enabled:' + card.enabled + ' ,IsDefault:' + card.IsDefault + ' , IsInitialized:' + card.IsInitialized + ' ,typeSpeakers:' + card.typeSpeakers)
 
// [device],[freq],[flags] , -1 is default sound card
var result=basslib.BASS_Init(-1,44100,basslib.BASS_Initflags.BASS_DEVICE_STEREO)
if(!result){
  console.log('error init sound card:' + basslib.BASS_ErrorGetCode())
}

console.log("first card is init?:" + basslib.getDevice(1).IsInitialized)

// isMemoryFile,filename,offset,length,flags, returns pointer of file
var chan=basslib.BASS_StreamCreateFile(0,'c:\\mp3\\test.mp3',0,0,0)
if(basslib.BASS_ErrorGetCode()!=basslib.BASS_ErrorCode.BASS_OK){
  console.log('error opening file:' + basslib.BASS_ErrorGetCode())
}

//lets play
//channel,restart   , returns  (also there are stop , pause commands) 
var success=basslib.BASS_ChannelPlay(chan,-1)
if(!success){
  console.log('error playing file:' + basslib.BASS_ErrorGetCode())
}

Get Duration

//get the duration, bass returns the total bytes of the channel pointer, then we must convert it to seconds :) 
var durationInBytes= basslib.BASS_ChannelGetLength(chan,0)
var durationInSeconds=basslib.BASS_ChannelBytes2Seconds(chan,durationInBytes)

Get Duration Example2

//if stream is active (playing), then get position and duration..
setInterval(function(){
    if(basslib.BASS_ChannelIsActive(chan)==basslib.BASS_ChannelIsActiveAttribs.BASS_ACTIVE_PLAYING) {

        var position = basslib.BASS_ChannelBytes2Seconds(chan, basslib.BASS_ChannelGetPosition(chan, 0));
        var duration = basslib.BASS_ChannelBytes2Seconds(chan, basslib.BASS_ChannelGetLength(chan, 0))
        console.log(position + ' / ' + duration)
    }else{
        console.log('stopped' )
    }
},500)

Get Volume of channel

//get the volume
//first get the byte position of volume from attribute
var volume=0;
basslib.BASS_ChannelGetAttribute(chan,basslib.BASS_ChannelAttributes.BASS_ATTRIB_VOL,volume);

Set Volume

//lets set to 0.3
basslib.BASS_ChannelSetAttribute(chan,basslib.BASS_ChannelAttributes.BASS_ATTRIB_VOL,0.3)

Get current Position of playback

var positionInBytes= basslib.BASS_ChannelGetPosition(chan,0);
//now convert it to seconds
var position=basslib.BASS_ChannelBytes2Seconds(chan,positionInBytes);

Set Position

//first get the byte position of desired seconds (ex:to last 10 seconds
var Last10SecondsBytePos=basslib.BASS_ChannelSeconds2Bytes(chan,durationInSeconds-10);
basslib.BASS_ChannelSetPosition(chan,Last10SecondsBytePos);

Is channel is playing?

var result=basslib.BASS_ChannelIsActive(chan)
if(result==basslib.BASS_ChannelIsActiveAttribs.BASS_ACTIVE_PLAYING){
  console.log('channel is playing')
}

sliding

//Lets slide volume to 0 in 3 seconds (3000 milliseconds)
basslib.BASS_ChannelSlideAttribute(chan,basslib.BASS_ChannelAttributes.BASS_ATTRIB_VOL,0,3000)

callback

//lets make a callback when position reaches to 20. seconds.
var Pos20SecondsBytePos=basslib.BASS_ChannelSeconds2Bytes(chan,20);
var proc20SecondsID=basslib.BASS_ChannelSetSync(chan,basslib.BASS_ChannelSyncTypes.BASS_SYNC_POS,Pos20SecondsBytePos,function(handle,channel,data,user){
   if(handle==proc20SecondsID){ 
      console.log('position reached to the 20 seconds..')
   }
})

//lets get the event when the position reaches to end
var procTOENDID=basslib.BASS_ChannelSetSync(chan,basslib.BASS_ChannelSyncTypes.BASS_SYNC_END,0,function(handle,channel,data,user){
   if(handle==procTOENDID){ 
      console.log('playback finished..')
   }
})

vumeter

//lets get vumeter :)
 var levels=basslib.BASS_ChannelGetLevel(chan);
 //its a 64 bit value, lets get lo and hiwords
 var rightlevel=basslib.toFloat64(levels)[0]
var leftlevel=basslib.toFloat64(levels)[1]

close the file

if(basslib.BASS_ChannelIsActive(chan)==basslib.BASS_ChannelIsActiveAttribs.BASS_ACTIVE_PLAYING){
  //stop the channel
  basslib.BASS_ChannelStop(chan);
  }

  var result=basslib.BASS_StreamFree(chan)
  if(!result){
    console.log('stream free error:' + basslib.BASS_ErrorGetCode())
  }

change sound card

  //first check if this sound card is initialized
  var soundCardIndex=1;
  var info=basslib.getDevice(soundCardIndex);
  if(!info.enabled){
    console.log('this device is not enabled')
  }
  if(!info.IsInitialized){
        var result= basslib.BASS_Init(soundCardIndex,44100,basslib.BASS_Initflags.BASS_DEVICE_STEREO);
        if(result!=basslib.BASS_ErrorCode.BASS_OK){
          console.log('error init sound card:' + basslib.BASS_ErrorGetCode())
        }
  }
  var success=basslib.BASS_ChannelSetDevice(chan,soundCardIndex)
  if(!success){
      console.log('error init sound card:' + basslib.BASS_ErrorGetCode())
   }

Info of a channel

var info=    basslib.BASS_ChannelGetInfo(chan);
console.log('info.ctype:' + info.ctype)
    console.log("is channel an mp3 stream?:" + (info.ctype ==basslib.BASS_CHANNELINFOtypes.BASS_CTYPE_STREAM_MP3))
//other infos are: freq,chans,flags,ctype,origres,plugin,sample,filename

Free the memory from bass

   basslib.BASS_Free();

MIXER FEATURES

Enable Mixer

//before using mixer, first enable it. and put the required component to root folder.
basslib.EnableMixer(true);

Mixer is Enabled?

//before using mixer, first enable it. and put the required component to root folder.
console.log(basslib.MixerEnabled());

Create mixer stream

basslib.EnableMixer(true);
var mixer=basslib.BASS_Mixer_StreamCreate(44100, 2,basslib.BASSFlags.BASS_SAMPLE_FLOAT);
var chan1=basslib.BASS_StreamCreateFile(0,'d:\\mp3\\tes1.mp3',0,0,basslib.BASSFlags.BASS_STREAM_DECODE | basslib.BASSFlags.BASS_SAMPLE_FLOAT)
var chan2=basslib.BASS_StreamCreateFile(0,'d:\\mp3\\test2.mp3',0,0,basslib.BASSFlags.BASS_STREAM_DECODE | basslib.BASSFlags.BASS_SAMPLE_FLOAT)
var ok1 = basslib.BASS_Mixer_StreamAddChannel(mixer, chan1, basslib.BASSFlags.BASS_SAMPLE_DEFAULT);
var ok2 = basslib.BASS_Mixer_StreamAddChannel(mixer, chan2, basslib.BASSFlags.BASS_SAMPLE_DEFAULT);
basslib.BASS_ChannelPlay(mixer,0)

Get current Position of mixer playback

var positionInBytes= basslib.BASS_Mixer_ChannelGetPosition(chan,0);
//now convert it to seconds
var position=basslib.BASS_ChannelBytes2Seconds(chan,positionInBytes);

ENCODER FEATURES

you can directly encode and send output to shotcast and icecast servers

use mixer as a trick, because if the channel freed or added new channel, the encoder stops itself.

add channels to mixer every time, and add mixer channel to encoder. so the encoder never stops..

Init encoder

basslib.EnableMixer(true);
var mixer=basslib.BASS_Mixer_StreamCreate(44100, 2,basslib.BASSFlags.BASS_SAMPLE_FLOAT);
var chan=basslib.BASS_StreamCreateFile(0,'d:\\mp3\\tes1.mp3',0,0,basslib.BASSFlags.BASS_STREAM_DECODE | basslib.BASSFlags.BASS_SAMPLE_FLOAT)
var ok = basslib.BASS_Mixer_StreamAddChannel(mixer, chan, basslib.BASSFlags.BASS_SAMPLE_DEFAULT);

bass.EnableEncoder(true);

//lets try icecast
var enc_chan=basslib.BASS_Encode_Start(mixer,'lame -r -m s -s 22050 -b 56 -',bass.BASS_Encode_Startflags.BASS_ENCODE_NOHEAD);
var result=basslib.BASS_Encode_CastInit(enc_chan,
                                     'http://server-ip:8000/test',
                                     'password',
                                     bass.BASS_Encode_CastInitcontentMIMEtypes.BASS_ENCODE_TYPE_MP3,
                                     'test stream',
                                     'http://your-server-ip',
                                     'pop',
                                     'this is my new icecast test',
                                     'header1\r\nheader2\r\n',
                                     44100,
                                     true //public
                                     );

basslib.BASS_ChannelPlay(mixer,0);                                     

get notification from encoder server

var result=basslib.BASS_Encode_SetNotify(enc_chan,function(handle,status,user){
  if(status==basslib.EncoderNotifyStatus.BASS_ENCODE_NOTIFY_CAST){
  console.log('server connection is dead');
});

INFO i only added methods, properties what i needed.. add yours to the code or send me mail..

UPDATE LOG

--------------------------------

• 1.0.0-rc.15

  • documentation fix

• 1.0.0-rc.14

  • documentation fix

• 1.0.0-rc.13

  • new mixer features:

    • BASS_Mixer_StreamCreate
    • BASS_Mixer_StreamAddChannel
    • BASS_Mixer_ChannelGetLevel
    • BASS_Mixer_ChannelGetMixer
    • BASS_Mixer_ChannelGetPosition
    • BASS_Mixer_ChannelRemove
    • BASS_Mixer_ChannelRemoveSync
    • BASS_Mixer_ChannelSetPosition
    • BASS_Mixer_ChannelSetSync

  • new encoder features:

    • BASS_Encode_Start
    • BASS_Encode_IsActive
    • BASS_Encode_SetNotify
    • BASS_Encode_SetPaused
    • BASS_Encode_Stop
    • BASS_Encode_CastInit
    • BASS_Encode_CastGetStats
    • BASS_Encode_CastSetTitle

• 1.0.0-rc.12

  • BASS_ChannelBytes2Seconds and BASS_ChannelSeconds2Bytes returns wrong on arm cpu. pos value type changed to int64. now works correctly