dongle-pie v1.0.4

Dongle Pie

This is a node.JS module that will let you listen for new flash media on linux based system. It works by essentially exploiting the wonderful df command. FOR LINUX ONLY.

Goal of this project is to allow people to easily listen to usb devices or mounted devices without much hassle.

Installation

dongle-pie is a npm porduct.

$ npm i dongle-pie

Getting Started :: Query Currently Mounted

You can create one of two things with this system, a listener for new and current media devices or just query the currently mounted devices.

var dongleDetector = require('dongle-pie');
dongleDetector.getCurrentlyMounted(function(err, devices){
  console.log(devices);
});

This will output an array of mounted media, this will apply no filter on the ouput devices. We will discuss filtering on the listener section of this guide.

The output will contain the following contents:

Getting Started :: Create Event Listneres for Mounted

As discussed, you can also create event listneres that will get called on new or removed mounted media as such.

var dongleDetector = require('dongle-pie');

dongleDetector.watchStorage();

dongleDetector.storage.on('newDevice', function(drive){
  console.log("we want to link ->"+drive.target);
});

dongleDetector.storage.on('removedDevice', function(drive){
  console.log("we want to unlink ->"+drive.target);
});

This will create a rather basic event listener. By default we apply a filter on a signal as well as set a default 1000ms interval between df query. The default signal filter is applied and it will only call the newDevice if thie new or removed drive is mounted on a "/media/". Do note you can overide them and listen to any and all new media like such.

dongleDetector.watchStorage(filter, interval);

We expect a function in the filter and an interval in int format in ms.

Lets create a listener that will trigger on any new media and not just media mounted to "/media/".

var dongleDetector = require('dongle-pie');

dongleDetector.watchStorage(function(driveToFilter){
    return true;
}, 500);

dongleDetector.storage.on('newDevice', function(drive){
  console.log("we want to link ->"+drive.target);
});

dongleDetector.storage.on('removedDevice', function(drive){
  console.log("we want to unlink ->"+drive.target);
});

We created listeners that will be called on any and all mounted media events with a query interval of 500ms.

Todos

• Mac compatibility
• Tests
• Less strict parsing df qurery rules.

License

MIT