File Organizer Pro – User Guide
Table of Contents
1. Introduction
2. System Requirements
3. Installation
4. Launching the Application
5. Using File Organizer Pro
o Selecting Source & Target Folders
o Previewing Files
o Organizing Files
o Undoing Operations
6. Configuration
7. Logging & Troubleshooting
8. FAQ
9. Contact Support
1. Introduction
File Organizer Pro is a desktop application that helps you clean up messy
folders by automatically categorizing files into structured folders such as
Documents, Images, Videos, Music, and Others. It provides a preview before
organizing and supports undoing the last operation.
2. System Requirements
Windows 10 or higher / Linux / macOS
Python 3.9+
Tkinter library installed
3. Installation
1. Download the project folder or ZIP file.
2. Install required dependencies:
pip install -r [Link]
3. Run the application:
python file_organizer.py
4. Launching the Application
Double-click file_organizer.py or run via terminal.
The main interface will appear with:
o Source Folder button
o Target Folder button
o Preview Panel showing files to be moved
o Organize and Undo buttons
![Screenshot Placeholder – Main Interface]
5. Using File Organizer Pro
5.1 Selecting Source & Target Folders
1. Click Source Folder to select the folder containing files you want to
organize.
2. Click Target Folder to select the destination where files will be
moved.
3. Only after both folders are selected, you can proceed to preview or
organize.
![Screenshot Placeholder – Folder Selection]
5.2 Previewing Files
After selecting folders, the Preview Panel shows all files from the
source folder along with their predicted category.
Example preview:
Preview — Files to be moved:
.platform → Others
[Link] → Others
[Link] → Others
[Link] → Others
Accessible_Tidal5378759637487254.json → Others
[Link] → Images
[Link] → Images
[Link] → Others
Review this list carefully to ensure files are categorized correctly
before organizing.
![Screenshot Placeholder – Preview Panel]
5.3 Organizing Files
1. Click Organize to move the files from the source folder to the target
folder according to the categories.
2. The app will create subfolders inside the target folder (Documents,
Images, Others, etc.) if they don’t exist.
3. Files are moved safely, and the Preview Panel updates to show the
organized status.
![Screenshot Placeholder – Organize Operation]
5.4 Undoing Operations
If you made a mistake or want to revert the last operation, click Undo.
The app moves files back to their original locations from the target
folder.
Undo works only for the most recent organize operation.
![Screenshot Placeholder – Undo Operation]
6. Configuration
File categories are defined in [Link].
Add or remove file types as needed:
{
"Documents": [".pdf", ".docx", ".txt"],
"Images": [".jpg", ".png", ".gif"],
"Others": []
}
7. Logging & Troubleshooting
Logs are saved in [Link].
Common issues:
o Permission Denied: Make sure folders are writable.
o File in Use: Close programs using the file.
8. FAQ
Q: Can I organize multiple source folders at once?
A: No, only one source folder at a time is supported.
Q: Can I customize categories?
A: Yes, modify [Link].
9. Contact Support
For issues or feature requests, email: support@[Link]
