File Organizer with Auto-Watcher

A simple yet powerful file organization system that automatically categorizes files and monitors directories for changes.

Features

• 📂 Organizes files by type (documents, images, videos, etc.)
• 🔄 Monitors directories for changes in real-time
• 🔔 Sends desktop notifications for file operations
• ⚡ Runs as a background service by default
• 🛠️ Easy to configure and extend

Prerequisites

• Linux-based OS (tested on Ubuntu)
• Python 3.x
• inotify-tools (for file watching)
• notify-send (for desktop notifications)

Install dependencies on Ubuntu/Debian:

sudo apt update
sudo apt install inotify-tools

Installation

1. Clone this repository
2. Make the script executable:

   chmod +x fwatch

Usage

Basic Usage

# Watch and organize ~/Downloads (runs in background by default)
./fwatch -d ~/Downloads

Options

-d, --directory PATH  Directory to watch (default: ~/Downloads)
--foreground        Run in foreground (default: runs in background)
-h, --help          Show this help message

Running in Foreground (for debugging)

./fwatch -d ~/Downloads --foreground

Stopping the Watcher

# Stop all file watcher instances
pkill -f fwatch

File Organization

Files are organized into these categories:

• documents/ - PDFs, Word, Excel, etc.
• images/ - JPG, PNG, GIF, etc.
• videos/ - MP4, AVI, MKV, etc.
• audios/ - MP3, WAV, etc.
• compressed/ - ZIP, RAR, TAR, etc.
• scripts/ - Python, Bash, etc.
• others/ - All other files

License

MIT License - See LICENSE for details.