Folder Watcher Automation

Overview

Python automation script that watches a folder for new files.
When a file appears, the script automatically renames it with a timestamp and moves it to a processed folder.

This project simulates a real-world automation task where files arrive continuously and must be handled without manual work.

What this project does

• Watches an input folder for newly added files
• Detects file creation events automatically
• Filters files by allowed extensions
• Renames each new file with date and time
• Moves processed files into a separate folder

Project Structure

• input/ — folder where new files are added
• processed/ — folder where renamed files are moved
• logs/ — reserved for future log files
• src/config.py — stores folder paths and settings
• src/watcher.py — watches the input folder for new files
• src/processor.py — renames and moves detected files
• src/main.py — starts the watcher program

What this shows

• Working with file paths using Path objects
• Monitoring folders using a filesystem watcher
• Organizing code into clear modules
• Automating file handling tasks
• Building a clean project structure

How to run the project

1. Make sure Python is installed
2. Install required library:

pip install watchdog

3. Run the program from the src folder:

python main.py

4. Add any .txt, .csv, or .pdf file into the input folder
5. The file will be renamed and moved automatically to processed

Notes

This is a learning project built to practice automation, folder monitoring, and clean project organization in Python.

Last updated: January 2026