fswatch is a cross-platform, file change monitor that gets notification alerts when the contents of the specified files or directories are altered or modified.
It executes four types of monitors on different operating systems such as:
- A monitor build on the File System Events API of Apple OS X.
- A monitor based on kqueue, a notification interface present in FreeBSD 4.1 also supported on many *BSD systems, OS X inclusive.
- A monitor based on File Events Notification API of the Solaris kernel plus its spin-offs.
- A monitor based on inotify, a kernel subsystem that shows file system modifications to apps.
- A monitor based on ReadDirectoryChangesW, a Windows API that records alters to a directory.
- A monitor that regularly check that status of file system, keeps file modification times in memory, and manually determine file system changes (which works anywhere, where stat can be used).
Features of fswatch
- Supports several OS-specific APIs
- Allows recursive directory monitoring
- Performs path filtering using including and excluding regular expressions
- Supports customizable record format
- Additionally, it supports periodic idle events
How To Install fswatch in Linux Systems
Unfortunately, fswatch package is not available to install from the default system repositories in any Linux distributions. The only way to install the latest version of fswatch is to build from source tarball as show in the following installation instructions.
First grab the latest fswatch tarball using following wget command and install it as shown:
$ wget https://github.com/emcrisostomo/fswatch/releases/download/1.9.3/fswatch-1.9.3.tar.gz $ tar -xvzf fswatch-1.9.3.tar.gz $ cd fswatch-1.9.3 $ ./configure $ make $ sudo make install
Important: Make sure you’ve GNU GCC (C and C++ Compiler) and Development Tools (build-essential on Debian/Ubuntu) installed on the system, before you compile fswatch from source. If not, install it using following command on your respective Linux distributions..
# yum group install 'Development Tools' [On CentOS/RHEL] # dnf group install 'Development Tools' [On Fedora 22+ Versions] $ sudo apt-get install build-essential [On Debian/Ubuntu Versions]
On Debian/Ubuntu distributions, you might get following error while executing fswatch command..
fswatch: error while loading shared libraries: libfswatch.so.6: cannot open shared object file: No such file or directory
To fix it, you need to execute the command below, this will help refresh the links and cache to the dynamic libraries before you can start using fswatch.
$ sudo ldconfig
How do I use fswatch on Linux?
The general syntax for running fswatch is:
$ fswatch [option] [path]
On Linux, it is recommended that you use the default inotify monitor, you can list available monitors by employing the
- list-monitors option:
$ fswatch -M $ fswatch --list-monitors
The command below enables you to watch the changes in the current directory (
/home/tecmint), with events being delivered to standard output every 4 seconds.
-l or –
-latency option allows you to set the latency in seconds, the default being 1 second.
$ fswatch -l 4 .
The next command monitors changes to the /var/log/auth.log file every 5 seconds:
$ fswatch -l 5 /var/log/auth.log
--timestamp option prints the time stamp for every event, to print the time in UTC format, employ
--utf-time option. You can as well format time using
--format-time format option:
$ fswatch --timestamp /var/log/auth.log
--event-flags tells fswatch to print the event flags along side the event path. You can use –event-field-seperator option to print events using the particular separator.
$ fswatch --events-flags ~ /var/log/auth.log
To print the numeric value of an event indicating changes in your home directory and /var/log/auth.log file, use
--numeric option as below:
$ fswatch --numeric ~ /var/log/auth.log
Perhaps you can look through the fswatch man page for detailed usage options and information:
$ man fswatch
For more information and usage, visit fswatch Github repository: https://github.com/emcrisostomo/fswatch
In this post, we covered a simple command line utility to help Linux users get notified when the contents of specified files or directory hierarchies are modified.
I hope all went well with the installation, if that is not the case for you, make an effort to reach us via the feedback form below. In addition, in case you have used it before, you may want to offer us some thoughts about your experience with fswatch.
9 thoughts on “fswatch – Monitors Files and Directory Changes or Modifications in Linux”
The tutorial is a bit outdated I think. Also the installation doesn’t seem to work out of the box completely.
Here’s what I had to do on (X)ubuntu 17.04 for making it work:
This guide was based on Ubuntu 16.04 and 14.04; though, we’ll cross check this. Thanks for sharing this useful information.
Nice Terminal theme in screenshot Which terminal and theme you are using ?
Thanks for your great guide.
First I have to say that one of your command in this guide must be correct :
groupinstall in not separate and must be :
second is that when I want to run ./configure command to install fswatch in centos 6.5.
I faced is below error :
and soulotion is in below link :
it would be great if you add solution to this guide.
Yes, you was correct there should be isn’t any space between “group install”, the correct command is:
Please install gcc libraries before compiling fswatch..
If you still get the same erro, then do
Do they have this for CentOs and Rhel?
Yes, please see the installation section and follow the instructions to install on CentOS or RHEL based systems..
Good One Learned a New command from here.
That’s great, thanks for stopping by.