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.

Source Distribution

watch-fs-1.5.0.tar.gz (3.3 kB view hashes)

Uploaded source

Built Distribution

watch_fs-1.5.0-py2.py3-none-any.whl (5.4 kB view hashes)

Uploaded 3 4

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page