Smart File Organizer (Python)

01Overview

The Python edition of Smart File Organizer keeps folders that constantly fall apart — Downloads, Desktop — tidy automatically. Writing the same product twice, in two languages and ecosystems, was a good exercise in seeing how much architecture depends on the language.

It shares the safety principles of the Java version: no deletes, no silent overwrites, dry run first. On top of that it adds live monitoring through watchdog with a settle delay, so a file being copied is not moved mid-write.

02Key Features

• Dry run — a preview table with file, current path, target and category columns
• 11 categories — images, video, audio, PDFs, documents, spreadsheets, presentations, archives, code, installers and other
• Collision safety — renames to file (1).pdf, never overwrites
• Undo — revert the last batch through data/history.json
• Live monitoring — catch new files via watchdog with a settle delay
• Turkish UI — interface strings collected in app/i18n.py

03Engineering Notes

• System files such as desktop.ini are skipped and category subfolders are not re-scanned by default, so the tool never reprocesses its own output.
• Python 3.11+, CustomTkinter and pytest, with an optional PyInstaller .exe build.