A beautiful, state-of-the-art Windows application for organizing your files using virtual views. Features a modern dark-themed UI with one-click operation. No installation required - just download and run the .exe file!
- 🎨 State-of-the-Art Design - Beautiful dark-themed interface inspired by professional tools
- 🌓 Theme Toggle - Switch between dark and light modes
- 📊 Real-time Dashboard - Live statistics showing files, size, categories, duplicates
- ⚡ One-Click Operation - Single button does everything automatically
- 📈 Progress Tracking - Visual progress bar with phase-by-phase updates
- 📋 Activity Log - Detailed real-time logs of all operations
- Zero Installation - Single executable file, runs immediately
- 5 Organization Views - Category, Date, Size, Extension, and Duplicates
- Virtual Organization - Creates symbolic links without moving files
- Smart Categorization - Recognizes 70+ file types automatically
- Duplicate Detection - SHA-256 hashing with wasted space calculation
- Safe Operations - Original files are never modified or moved
Beautiful, professional interface with dark theme, real-time statistics, and one-click operation
- Download
FileOrganizer.exefrom the Releases page - Double-click to run - no installation needed!
- Select your folder and start organizing
# 1. Clone the repository
git clone https://github.com/veritarium/FileOrganizerWindows.git
cd FileOrganizerWindows
# 2. Install dependencies
pip install -r requirements.txt
# 3. Run directly
python file_organizer_gui.py
# OR build your own .exe
python build_exe.py
# Your .exe will be in the dist/ folderWindows Users: For easy dependency installation, you can also run install.bat (double-click) which will automatically install Python dependencies.
- Select Directory - Click "Browse" and choose your folder
- Click "Scan & Organize All" - One button does everything!
- Watch the Magic - Real-time progress and statistics
- Browse Results - Open the
_Viewsfolder to see your organized files
That's it! The application automatically:
- ✅ Scans all files and extracts metadata
- ✅ Computes file hashes for duplicate detection
- ✅ Creates 5 different organization views
- ✅ Shows you detailed statistics and results
70+ file types organized intelligently:
_Views/ByCategory/
Documents/PDF/
Documents/Word/
Images/Photos/
CAD/AutoCAD/
Code/Python/
...
Year and month folders:
_Views/ByDate/
2025/01-January/
2025/02-February/
2024/12-December/
...
5 size ranges:
_Views/BySize/
Tiny (< 1 KB)/
Small (1 KB - 1 MB)/
Medium (1-10 MB)/
Large (10-100 MB)/
Very Large (> 100 MB)/
Raw file extensions:
_Views/ByExtension/
PDF/
DOCX/
JPG/
DWG/
...
Groups identical files:
_Views/Duplicates/
document_duplicates/
document.pdf -> location1/
document.pdf -> location2/
photo_duplicates/
photo.jpg -> location1/
photo.jpg -> location2/
The application recognizes 70+ file types including:
- Documents: PDF, Word, Excel, PowerPoint, Text files
- Images: JPG, PNG, GIF, BMP, SVG, AI
- CAD Files: DWG, DXF, SKP
- Videos: MP4, AVI, MKV, MOV
- Audio: MP3, WAV, FLAC
- Archives: ZIP, RAR, 7Z, TAR
- Code: Python, JavaScript, Java, C++, HTML, CSS
- Read-only operations - Original files are never touched
- Symbolic links - Virtual organization with zero storage overhead
- Hidden database - All metadata stored in
.file_organizer.db - Skip _Views folder - The tool ignores its own virtual views during scans
The status bar shows:
- Current operation (Scanning, Organizing, etc.)
- Progress indication
- Completion messages
- Error notifications
The main text area displays:
- Detailed operation logs
- File counts and statistics
- Errors and warnings
- View locations
- OS: Windows 10 or later (Windows 11 recommended)
- Python: 3.11+ (only if building from source)
- Permissions: Administrator privileges may be required for symbolic links
- Tip: Enable Developer Mode in Windows Settings to avoid admin prompts
- Open Settings → Privacy & Security → For developers
- Turn on Developer Mode
- Restart if prompted
- Now you can create symbolic links without admin rights!
# Install Python 3.11 or later
# Download from https://www.python.org/downloads/
# Install dependencies
pip install -r requirements.txt# Run the build script
python build_exe.py
# Your executable will be in:
dist/FileOrganizer.exe
# Test it
cd dist
FileOrganizer.exeThe build script uses PyInstaller with these options:
--onefile- Single executable file--windowed- No console window (GUI only)--clean- Clean build directory first- Hidden imports for tkinter and sqlite3
Solution: Enable Developer Mode (see above) or run as Administrator
Solution:
pip install --upgrade pip
pip install -r requirements.txtWindows Users: You can also run install.bat to automate dependency installation.
Solution:
- Ensure you're on Windows 10 or later
- Try running from command prompt to see error messages
- Check antivirus didn't block the .exe
Solution:
- This is normal for folders with many files
- Close other applications during scan
- Consider scanning smaller folders first
Solution:
- Ensure Developer Mode is enabled
- Run as Administrator
- Check that original files still exist
Q: Does this move my files? A: No! It only creates symbolic links (shortcuts) to organize views.
Q: Can I delete the _Views folder? A: Yes! It only contains links. Deleting it won't affect your original files.
Q: What is the .file_organizer.db file? A: It's a hidden SQLite database containing file metadata. Safe to delete if you want to rescan.
Q: Can I organize multiple folders? A: Yes! Just select a different folder and scan again. Each folder gets its own database.
Q: What happens if I move the original files? A: The symbolic links will break. You'll need to rescan and reorganize.
Q: Is this safe for production files? A: Yes! The tool only reads files, never modifies them. However, always keep backups of important data.
- Requires Windows 10 or later
- Symbolic links need Developer Mode or admin rights
- Large scans (60,000+ files) may take several minutes
- Duplicate detection requires computing file hashes (slower for large files)
FileOrganizerWindows/
├── file_organizer_gui.py # Main GUI application
├── build_exe.py # Build script for .exe
├── requirements.txt # Python dependencies
├── README.md # This file
└── dist/ # Build output (after running build_exe.py)
└── FileOrganizer.exe # Standalone executable
- GUI Framework: tkinter (built into Python)
- Database: SQLite3 (built into Python)
- Hashing: SHA-256 via hashlib (built into Python)
- Threading: Background threads for non-blocking UI
- Build Tool: PyInstaller for standalone .exe
Files are categorized using:
- Extension-based mapping (70+ types)
- Filename pattern matching (e.g., "screenshot" → Images/Screenshots)
- Fallback to "Miscellaneous/Unknown"
- Computes SHA-256 hash for each file
- Groups files with identical hashes
- Calculates wasted space
- Creates organized view in _Views/Duplicates/
This project is licensed under the MIT License. See LICENSE file for details.
Contributions are welcome! Feel free to:
- Report bugs
- Suggest features
- Submit pull requests
- Issues: GitHub Issues
- Discussions: GitHub Discussions
This is a simplified Windows GUI version of the full-featured Virtual File Organizer project.
For advanced features like:
- Custom view definitions (YAML rules)
- Web-based search interface
- Advanced metadata extraction
- Project detection
- Command-line interface
Check out the full version!
This tool creates symbolic links to organize files virtually. While it does not modify original files:
- Always have backups of important data
- Test with a small dataset first
- Understand that symbolic links are pointers to original files
- The authors are not responsible for any data loss
Use at your own risk.
Made with love for file organization on Windows ❤️
Star this repo if you find it useful! ⭐