Python API library and shell utilities to monitor file system events.

Directory monitoring made easy with

  • A cross-platform API.
  • A shell tool to run commands in response to directory changes.

Get started quickly with a simple example in Quickstart.

Easy installation

You can use pip to install watchdog quickly and easily:

$ pip install watchdog

Need more help with installing? See Installation.


Found a bug in or want a feature added to watchdog? You can fork the official code repository or file an issue ticket at the issue tracker. You can also ask questions at the official mailing list. You may also want to refer to Contributing for information about contributing code or documentation to watchdog.

Indices and tables

Table Of Contents

Next topic