Yet another nodejs implementation. Good for large directory structure with lot of files.
Latest commit 7b533ca Dec 7, 2016 @kerphi kerphi committed on GitHub Merge pull request #6 from gfiorello/master
Removed double quotes from --exclude param
Failed to load latest commit information.
examples added example Jul 18, 2013
lib Remove unused break Dec 7, 2016
test fix tests Jan 24, 2014
.gitignore Add options for bin, excludes, files, events, spawningArgs Jun 16, 2016
.travis.yml travis Jun 16, 2016
LICENSE first import Jul 6, 2013
index.js first import Jul 6, 2013
package.json 1.8.2 Nov 10, 2016


Build Status

Yet another nodejs implementation that can watch:

  • folders recursively
  • big number of directories and files
  • with low CPU use

This implementation is a wrapper above the inotifywait system command.


Because other implementations:

Are not performant for huge number of directories and files watching. Some are not recursive, other have high CPU usage when watching lot of directories and files.


npm install inotifywait

Prerequisit is to have the inotifywait command in the current PATH. On debian/ubuntu, you have to sudo apt-get install inotify-tools


  • add (p1 = filename, stats): received when a file or directory is added

  • change (p1 = filename, stats): received when a file is modified

  • unlink (p1 = filename, stats): received when a file or directory is deleted

  • unknown (p1 = filename, p2 = full raw event object, stats): received when unknown action is done on a file or directory

  • ready (p1 = unix process object): received when inotifywait is ready to watch files or directories

  • close (no parameter): received when inotifywait exited

  • error (p1 = error object): received when an error occures

stats has two properties, isDir a Boolean to specify if the event was on a file or a directory and date a Date object that holds the date of the occured event.


var INotifyWait = require('inotifywait');

var watch1 = new INotifyWait('/tmp/', { recursive: false });
watch1.on('ready', function (filename) {
  console.log('watcher is watching');
watch1.on('add', function (filename) {
  console.log(filename + ' added');
  watch1.close(); // stop watching

var watch2 = new INotifyWait('/var/log/', { recursive: true });
watch2.on('change', function (filename) {
  console.log(filename + ' changed');
  watch2.close(); // stop watching

var watch3 = new Inotifywait("/my/dir", {
            recursive: true, // recurse sub folders
            excludes: ["\./\.git(.*)"], // exclusion regex patterns
            files: [".gitignore"], // explicit file paths to ignore
            events: ["create", "move", "delete"], // events to listen to
            spawnArgs: {stdio: "inherit"}, // spawn args controlling bin spawning
            bin: "/home/me/bin/inotifywait" // bin path
watch3.on('change', function (filename) {
  console.log(filename + ' changed');
  watch3.close(); // stop watching