Python File Organizer
with GUI
Team Members: Vaibhav Choudhary , Akul Gupta , Parmanand Singh , Aru
Ashish Gupta
Project Type: Desktop Application / Automation Tool
Technology Stack: Python, Tkinter, OS/Pathlib, Shutil, JSON, Threading
INTRODUCTION
The Python File Organizer is a desktop-based file automation tool
designed to solve the everyday problem of unorganized folders.
Over time, users accumulate a large number of files—documents,
images, videos, PDFs, zips, and more—making manual
organization difficult and time-consuming.
This project provides a smart and automatic solution by
arranging files systematically based on:
File extensions (grouping by file type)
File modification dates (grouping by year/month/day)
Combined criteria, allowing multi-level folder structuring
Smart Features :-
This application offers a fully interactive Tkinter-based GUI, ensuring a smooth and user-friendly
experience. It eliminates command-line complexity and allows users to perform file operations through
simple clicks.
1 2
Move or Copy Modes Dry-run Preview
Reorganize files or keep duplicates—your choice Shows all actions before executing to prevent mistakes
3 4
Undo Operations Live Progress
Maintains JSON log to restore previous file states Real-time percentage-based progress bar and status up
5 6
Safe Cancel Threading Support
Interrupt operations without corrupting data GUI remains responsive during large operations
Solution Approach: The
Organization Process
Folder Input
User selects target folder through Tkinter dialog.
Optional custom destination folder supported.
Sorting Logic Selection
By Extension: Images, Videos, DocumentsBy Date: Year
and month groupingCombined: Extension + Date or Date
+ Extension
File Scanning
Uses Pathlib to scan directory contents. Ignores log
files and internal folders automatically.
Dynamic Structure
Creates directories only when needed. Ensures no duplicate fo
Target Folder
THE GUI INTERFACE Sub-organize by Date
Select the folder whose files Creates date-based folders
you want to organize inside the primary category.
Example:
Images/2025-11/[Link]
Destination (Optional)
Choose where organized files
should be saved. If empty,
uses the target folder itself. Run
Starts the actual organizing
task.
Dry-Run Button
Organize By Shows planned operations (no
Extension: Groups files by changes made).
type (Images, Documents, Cancel
Videos, etc.) Stops the task safely during
Modification Month/Day: execution.
Groups by last modified date. Undo Last
Reverts the most recent
move/copy operation using log
data.
Move Files / Copy Files
Save Log As
Checked = Move
Saves the Output/Progress text
Unchecked = Copy
to a file.
Controls whether originals
are deleted or preserved.
Individual Contribution
1. Vaibhav Choudhary 4. Arun Verma
Assisted in GUI layout planning and organizing interface elements
Helped implement folder selection, recursive scan, and filters Worked on sub organizing by date and combined sorting logic
Tested major functions like Move, Copy, and Dry-Run Assisted in threading, ensuring smooth and responsive GUI
Helped refine output logs and overall UX behavior
2. Akul Gupta
Worked on file scanning and classification logic 5. Ashish Gupta
Helped build extension-based and date-based sorting features Performed complete workflow testing (Scan → Organize → Undo)
Tested program behavior on various file types and sizes Verified extension filter, recursion, and destination logic
Assisted in debugging, UI cleanup, and final presentation
3. Parmanand Singh
Contributed to Undo system and JSON log handling
Assisted in safe file movement logic and cancellation behavior
Helped improve error handling and partial file cleanup
Real-World Applications And advantages
Downloads Media Organization Office Documents Student Workspace
Management
Sorts personal or Helps employees structure Instantly sorts
Automatically categorizes professional photos and reports, PDFs, assignments, notes,
documents, installers, videos into spreadsheets, and email projects, and study
photos, and zip files into year/month/day folder attachments efficiently materials for easy access
organized folders structures
Data Cleanup
Removes chaos from old
Impact: This system boosts. productivity, saves time, and
keeps digital storage clutter-free across all use cases
drives and creates clean,
structured archives for
long-term storage
References & Resources
⭐ References
Books & Documentation
•Python Official Documentation – Tkinter GUI Library
•Python Standard Library – os, shutil, pathlib, threading,
and json modules
Online Resources
•StackOverflow – Discussions and solutions for file handling & GUI
issues
•GeeksforGeeks – Tkinter layout and widget reference
•RealPython – Tutorials on file operations, threading, and GUI
design
•GitHub – Open-source file management utilities for idea inspiration
Project Resources
•[Link] tutorials for beginners & intermediate developers
•Personal experimentation and testing across multiple datasets