Skip to main content

Run commands when files change

Project description

watch-fs on PyPI watch-fs on PyPI Travis-CI build status for watch-fs GitHub issues for watch-fs

watch-fs is a command line tool to run commands when files change.


watch-fs will watch any number of directories and files, and run a command when any of them are changed. By default, watch-fs will watch the current directory.

Usage: watch-fs [OPTIONS] COMMAND

  -d, --directory DIRECTORY  A directory to watch for file changes - can be
                             used multiple times, and defaults to the current
  -c, --clear                Clear the terminal before running the command
  -w, --wait FLOAT           A minium wait before running the command again,
                             in seconds
  -v, --verbose              -v prints commands before running, and -vv shows
                             debug information


I recommend you use pipsi to install watch-fs in it’s own virtualenv and link it from ~/.local/bin:

pipsi install watch-fs

Alternatively, you can install system-wide using pip:

pip install watch-fs


watch-fs is licensed under the MIT Licence.


watch-fs was written by Sam Clements.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for watch-fs, version 1.5.0
Filename, size File type Python version Upload date Hashes
Filename, size watch_fs-1.5.0-py2.py3-none-any.whl (5.4 kB) File type Wheel Python version 3.4 Upload date Hashes View
Filename, size watch-fs-1.5.0.tar.gz (3.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page