Version 4.0

Security

• Removed pre-built Windows .exe files from releases due to security violations detected by Windows 11 and Sentinel One
• Added comprehensive Windows build instructions with code signing guidance to prevent security warnings
• Updated documentation to emphasize building from source or using CLI/TUI directly on Windows

Changed

• Updated version to 4.0 (major version bump due to removal of Windows binary distribution)
• All download links updated to v4.0
• Windows users must now build from source or use Python directly (see README for instructions)

Documentation

• Added "Building Windows Releases" section with code signing instructions
• Added security notice at top of README explaining Windows .exe removal
• Updated all version references to 4.0
• Refactored README for better flow, removed duplication, enhanced clarity

v3.5 - Universal Mac App (Intel + Apple Silicon)

What's New in v3.5

• Universal macOS app: Now works on both Intel and Apple Silicon Macs
• Build script updated to create universal2 binaries
• Fixed compatibility issues for Intel Mac users

Downloads

• macOS (Universal): Mac-File-Cleanup.zip - Works on both Intel and Apple Silicon Macs
• Windows: See v3.0 release for Windows build
• Source: See repository for source code

Changes

• Updated build script to use --target-arch universal2 for universal app support
• Rebuilt dependencies (markupsafe) as universal binaries
• Updated documentation with Intel Mac troubleshooting information

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

• 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

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

Version 2.5

What's new (v2.5)

• Fixed Mac app build: Now creates proper macOS .app bundle (Mac-File-Cleanup.zip contains Mac File Cleanup.app)
• Rebuilt desktop apps with bundled Flask under new names: Mac File Cleanup and Win-File-Cleanup
• Updated README download links to v2.5 assets
• Automation/build scripts aligned with new names
• CLI/TUI unchanged; CLI --html still expects Flask installed locally

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-2.5-source.zip

How to run

macOS

1. Download and unzip Mac-File-Cleanup.zip
2. Double-click Mac File Cleanup.app (first run: right-click and select "Open" 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

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
• Flask is bundled in the desktop apps; CLI --html still requires manual Flask installation

Version 2.1

What’s new (v2.1)

• Bundled Flask in the macOS and Windows desktop apps for zero-install launches
• Rebuilt both apps and updated README download links to the new assets
• CLI/TUI unchanged; CLI --html still expects Flask installed locally

Downloads

• macOS app: EasyFileCleanupGUI-mac
• Windows app: EasyFileCleanupGUI-windows.exe
• Source: EasyFileCleanup-2.1-source.zip

How to run

• Desktop: download your OS app and double-click; it opens the web UI on http://127.0.0.1:
• CLI: python3 Easy-File-Cleanup.py --html (requires Flask installed)
• CLI (no web): python3 Easy-File-Cleanup.py ~/Downloads

Notes

• Security: localhost-only; no external access
• If a downloaded app complains about Flask, re-download the v2.1 asset (it’s bundled).

Version 2.0

Version 2.0 release\n\nDownloads:\n- macOS: EasyFileCleanupGUI-mac\n- Windows: EasyFileCleanupGUI-windows.exe\n- Source: EasyFileCleanup-2.0-source.zip\n\nHighlights:\n- Desktop GUI launchers for macOS and Windows (double-click to start web UI)\n- Localhost-only security, auto browser launch\n- CLI/TUI remain unchanged

Version 1.5

What’s new (v1.5)

• Renamed desktop apps for clarity: Mac File Cleanup and Win-File-Cleanup
• Rebuilt both apps with Flask bundled for zero-install launch
• Updated automation/build scripts and README download links to the new names
• CLI/TUI remain unchanged; CLI --html still expects Flask installed locally

Downloads

• macOS app: Mac File Cleanup
• Windows app: Win-File-Cleanup.exe
• Source: EasyFileCleanup-1.5-source.zip

How to run

• Desktop: download your OS app and double-click; it opens the web UI on http://127.0.0.1:
• CLI: python3 Easy-File-Cleanup.py --html (requires Flask installed)
• CLI (no web): python3 Easy-File-Cleanup.py ~/Downloads

Notes

• Security: localhost-only; no external access
• If a downloaded app complains about Flask, re-download the v1.5 asset (it’s bundled).

Version 1.0

Initial stable release of Easy File Cleanup

Features

• Automatic file organization by extension
• Web interface with visual feedback and graphs
• Terminal User Interface (TUI) with ncurses
• Full automation support for scripts and cron jobs
• Cross-platform support (Windows, macOS, Linux)
• Comprehensive documentation

Installation

git clone https://github.com/StewAlexander-com/File_Cleanup.git
cd File_Cleanup
pip install Flask  # Optional, for web interface

Quick Start

# Web interface
python3 Easy-File-Cleanup.py --html

# Terminal interface
python3 Easy-File-Cleanup.py --tui

# Command line
python3 Easy-File-Cleanup.py ~/Downloads

See README.md for full documentation.