Skip to content

Version 3.0 - Mac App Fix

Choose a tag to compare

@StewAlexander-com StewAlexander-com released this 09 Dec 16:08
· 22 commits to master since this release

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, and directory_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

How to run

macOS

  1. Download and unzip Mac-File-Cleanup.zip
  2. Double-click Mac File Cleanup.app (first run: see First Run Instructions if you see a security warning)
  3. The web UI opens automatically in your browser

Windows

  1. Download Win-File-Cleanup.exe
  2. Double-click to run
  3. 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