Build a Desktop File Organizer in 35 Lines of Python — Weekend Project

Your Downloads folder is a mess. Mine was too — 400+ files, zero organization. So I spent a Saturday afternoon writing a Python script that watches a folder and auto-sorts files into subfolders by type. 35 lines, no external libraries beyond watchdog, runs forever in the background.

Here's the full weekend project. You'll have it running in under 30 minutes.

Why Build This?

Every developer I know has a chaotic Downloads folder. PDFs from 2019 sitting next to screenshots from yesterday. You could manually sort them — or you could automate it once and never think about it again.

This project teaches you:

• File system operations with os and shutil
• The watchdog library for real-time file monitoring
• How to build a script that runs as a background service

The Code

First, install the only dependency:

pip install watchdog

Now here's the complete script — file_organizer.py:

import os
import shutil
import time
from watchdog.observers import Observer
from watchdog.events import FileSystemEventHandler

# Configure your folder path and file type mappings
WATCH_DIR = os.path.expanduser("~/Downloads")

FILE_TYPES = {
    "Images": [".jpg", ".jpeg", ".png", ".gif", ".svg", ".webp"],
    "Documents": [".pdf", ".docx", ".xlsx", ".pptx", ".txt", ".csv"],
    "Videos": [".mp4", ".mkv", ".avi", ".mov"],
    "Audio": [".mp3", ".wav", ".flac", ".aac"],
    "Archives": [".zip", ".rar", ".tar", ".gz", ".7z"],
    "Code": [".py", ".js", ".html", ".css", ".json", ".sql"],
    "Installers": [".dmg", ".exe", ".msi", ".deb", ".pkg"],
}

def get_destination(filename):
    ext = os.path.splitext(filename)[1].lower()
    for folder, extensions in FILE_TYPES.items():
        if ext in extensions:
            return folder
    return "Other"

class SortHandler(FileSystemEventHandler):
    def on_created(self, event):
        if event.is_directory:
            return
        time.sleep(1)  # wait for download to finish
        filename = os.path.basename(event.src_path)
        dest_folder = get_destination(filename)
        dest_path = os.path.join(WATCH_DIR, dest_folder)
        os.makedirs(dest_path, exist_ok=True)
        try:
            shutil.move(event.src_path, os.path.join(dest_path, filename))
            print(f"Moved: {filename} -> {dest_folder}/")
        except Exception as e:
            print(f"Error moving {filename}: {e}")

if __name__ == "__main__":
    observer = Observer()
    observer.schedule(SortHandler(), WATCH_DIR, recursive=False)
    observer.start()
    print(f"Watching {WATCH_DIR} for new files...")
    try:
        while True:
            time.sleep(10)
    except KeyboardInterrupt:
        observer.stop()
    observer.join()

How It Works

The mapping dictionary (FILE_TYPES) maps folder names to file extensions. When a new file arrives, the script checks its extension and picks the right folder.

get_destination() loops through your mappings and returns the folder name. If the extension doesn't match anything, it goes to "Other" — nothing gets lost.

SortHandler extends watchdog's FileSystemEventHandler. The on_created method fires every time a new file appears. The 1-second sleep is important — it prevents the script from moving a file that's still downloading.

The main block creates an Observer that watches your Downloads folder. It runs in an infinite loop until you press Ctrl+C.

Make It Your Own

Here are 5 ways to extend this project:

1. Add date-based subfolders:

from datetime import datetime

def get_date_folder():
    return datetime.now().strftime("%Y-%m")
# Creates folders like "Documents/2026-04/"

2. Handle duplicate filenames:

def safe_move(src, dest_dir, filename):
    dest = os.path.join(dest_dir, filename)
    base, ext = os.path.splitext(filename)
    counter = 1
    while os.path.exists(dest):
        dest = os.path.join(dest_dir, f"{base}_{counter}{ext}")
        counter += 1
    shutil.move(src, dest)

3. Add desktop notifications (macOS):

import subprocess
def notify(title, message):
    subprocess.run(["osascript", "-e",
        f'display notification "{message}" with title "{title}"'])

4. Log everything to a file:

import logging
logging.basicConfig(filename="organizer.log", level=logging.INFO)
logging.info(f"Moved: {filename} -> {dest_folder}/")

5. Run it on startup — Add it to your crontab:

# crontab -e
@reboot python3 /path/to/file_organizer.py &

Real Numbers From My Setup

I've been running this on my machine for 3 months:

• 1,200+ files auto-sorted without lifting a finger
• Downloads folder went from 400 files to 7 organized subfolders
• Time saved: roughly 15 minutes per week of manual sorting
• At a modest consulting rate of ₹1,500/hr, that's ₹6,000/month in recovered time

The Bigger Lesson

This is a 30-minute project, but it teaches you a pattern that scales. The same watchdog + handler architecture works for:

• Auto-uploading invoices to Google Drive
• Parsing incoming CSVs and loading them into a database
• Monitoring log files for error patterns
• Triggering alerts when specific files land in a shared folder

Start small. Automate one annoying thing this weekend. Then next weekend, automate another.

Run It Now

pip install watchdog
# Save the script above as file_organizer.py
python file_organizer.py

Or just copy-paste the script above. It works out of the box.

---

I'm Archit Mittal — I automate chaos for businesses. Follow me for daily automation content.