Watchman is a C++ system-level CLI tool that monitors directories for file creation, modification, and deletion events in real time. This demo showcases Watchman running in the terminal, displaying live file system changes and logging them automatically. It is designed to explore operating system-level filesystem monitoring and system programming concepts using C++.
To get started quickly, follow these simple steps:
-
Check System Requirements
- Operating System: Windows, macOS, or Linux
- Required Libraries: Ensure you have the necessary C++ runtime libraries installed. Most common distributions will have these by default.
-
Download the Application
- Visit this page to download.
- You'll find different versions available. Select the most recent version for your platform.
-
Install the Application
- No installation is needed. Simply extract the downloaded zip file to your preferred directory.
-
Run Watchman
- Open your terminal or command prompt.
- Navigate to the directory where you extracted Watchman.
- Execute the Watchman binary.
- For Windows:
Watchman.exe - For macOS/Linux:
./Watchman
- For Windows:
-
Monitor a Directory
- After you run Watchman, use the command line to specify the directory you want to monitor. For example:
./Watchman /path/to/directory
- After you run Watchman, use the command line to specify the directory you want to monitor. For example:
- Real-Time Monitoring: See changes to files and folders as they happen.
- Logging: Automatically logs all modifications, deletions, and creations for easy reference.
- Command Line Interface: Simply use commands to set up and control your monitoring tasks.
- Cross-Platform Support: Operates on Windows, macOS, and Linux, making it versatile for various users.
- Always keep an eye on the terminal for real-time output.
- Adjust your command parameters according to the specific monitoring needs. For instance, you can add flags to filter which events you want to monitor.
If you encounter issues while running Watchman:
- Ensure your terminal has the necessary permissions to access the directories you want to monitor.
- Check if the binary is compatible with your operating system.
- Review the logs for any errors that might indicate what went wrong.
If you want to contribute to Watchman, please feel free to submit a pull request or open an issue on the repository.
- GitHub Repository: Watchman
- Documentation: Detailed documentation coming soon. Stay tuned.