node package manager

purr

Make your application purr. Add audio when functions and properties get called.

purr

Make your application purr. Add audio when functions and properties get called.

npm install purr

A module that allows you to make sounds when methods get called or error. Can be used with CLI's or any other modules you are working with.

This module is a scarlet plugin, and uses events on method calls to play sounds.

When a objects function is called, make a purr sound

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
purr.when(Math,'min').play();
 
Math.min(1,2,3);
//-> a purring sound will now be played on your speakers 

When a objects function is called make a sound using the predefined sounds

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
purr.when(Math,'min').play('bomb');
 
Math.min(1,2,3);
//-> a bomb sound will now be played on your speakers 

When a objects function is called call some sound file on your computer

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
purr.when(Math,'min').play('/home/user/myCustomSoundFile.wav');
 
Math.min(1,2,3);
//-> a sound will now be played on your speakers 

When a function instance is called make a purr sound

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
function FunctionObject(){
this.anyFunction = function(){};
this.anyFunction2 = function(){};
};
var instance = FunctionObject();
purr.when(instance).play();
 
instance.anyFunction();
//-> a purring sound will now be played on your speakers 
 
instance.anyFunction2();
//-> a purring sound will now be played on your speakers 

When a function instance errors make a sound

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
function FunctionObject(){
this.anyFunction = function(){throw new Error("some error")};
};
var instance = FunctionObject();
purr.whenError(instance).play('bomb');
 
instance.anyFunction();
//-> a bomb sound will now be played on your speakers 
//-> because the method threw an error 

When a function is called make a purr sound

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
function anyFunction(){};
anyFunction = purr.when(anyFunction).play();
 
anyFunction();
//-> a purring sound will now be played on your speakers 

purr provides a couple of sounds, but can be easily set to use any sound given a path

Sounds:

  • moo
  • purr
  • beep
  • bomb
  • donkey

This plugin requires Scarlet ~0.5.11

If you haven't used Scarlet before, be sure to check out the Documentation. To use this plugin perform the following:

Install scarlet

npm install scarlet --save

Install plugin

npm install purr --save

Once the plugin has been installed, you can use it in your application as follows:

//load scarlet 
var Scarlet = require('scarlet');
 
//Initialize scarlet with the plugin 
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;