user@devops:~$ cat README.md
FS Watcher
# Description
FS Watcher is a Linux file system monitor in C++23 that uses the inotify kernel API to watch directories and report file events in real time. Built with modern C++23, it uses the RAII pattern with std::expected for exception-free error handling and provides a clean callback-based architecture. It supports monitoring multiple directories simultaneously, reports events such as file creation, modification, deletion, and moves, and offers both human-readable text and JSON output for script integration. Includes event type filtering and experimental recursive subdirectory monitoring.
# Key features
$ Real-time monitoring using Linux kernel inotify API
$ Event detection: CREATE, MODIFY, DELETE, MOVED_FROM, MOVED_TO, ATTRIB and more
$ Multiple directory monitoring simultaneously
$ Human-readable and JSON output for scripting
$ RAII architecture with std::expected for robust error handling
$ Callback-based event handling with non-blocking polling
$ Experimental recursive subdirectory monitoring
# Gallery
# Technologies used
