Version 3.0 - Mac App Fix
What's new (v3.0)
🐛 Critical Fixes
- Fixed Mac app launch issue: Mac app now properly bundles Flask and all required Python modules
- Resolved "app doesn't open" problem: App now successfully launches and runs the Flask web server
- Improved error handling: Added error logging for easier debugging of windowed apps
🔧 Technical Improvements
- Enhanced PyInstaller build: Explicitly includes Flask dependencies and all Python modules
- Better module detection: Added explicit imports to ensure PyInstaller includes
file_cleanup,web_interface, anddirectory_browser - Build script updates: Improved macOS build process with better dependency handling
📦 What's Included
- macOS app: Fixed
Mac-File-Cleanup.zip(5.6MB) - now works correctly - Windows app:
Win-File-Cleanup.exe(unchanged from v2.5) - Source code: Complete Python source for CLI/TUI usage
Downloads
- macOS app: Mac-File-Cleanup.zip (contains Mac File Cleanup.app — unzip first, then double-click the .app)
- Windows app: Win-File-Cleanup.exe
- Source: EasyFileCleanup-3.0-source.zip
How to run
macOS
- Download and unzip
Mac-File-Cleanup.zip - Double-click
Mac File Cleanup.app(first run: see First Run Instructions if you see a security warning) - The web UI opens automatically in your browser
Windows
- Download
Win-File-Cleanup.exe - Double-click to run
- The web UI opens automatically in your browser
CLI
- Web interface:
python3 Easy-File-Cleanup.py --html(requires Flask installed) - Direct organize:
python3 Easy-File-Cleanup.py ~/Downloads
Upgrade Notes
If you downloaded v2.5 Mac app: The previous version had a critical bug preventing it from launching. Please download v3.0 for the fixed version.
Windows users: The Windows app is unchanged from v2.5, but you can download v3.0 for consistency.
Notes
- Security: localhost-only; no external access
- macOS first run: If you see a security warning, right-click the .app and select "Open" to bypass Gatekeeper, or follow the detailed instructions
- Flask is bundled in the desktop apps; CLI --html still requires manual Flask installation