Echo Cleaner v1.3.0

Release Date: October 23, 2025

🎯 What's New

Version 1.3.0 focuses on code quality improvements and bug fixes to make Echo Cleaner more maintainable and reliable.

✨ Highlights

• Better Architecture: Implemented SOLID principles with dedicated SelectionManager component
• Bug Fixes: Fixed dashboard clean button and selection summary visibility issues
• Cleaner Codebase: Reduced code duplication and improved maintainability

---

🏗️ Architecture Improvements

SelectionManager Component

• New dedicated class for managing item selection state
• Separation of Concerns: Selection logic isolated from UI code
• Testable: Can be tested independently from the UI
• Single Responsibility: Only handles selection state and calculations

UI Utilities Module

• Extracted common formatting functions (format_size, format_count)
• Reusable across different components
• Consistent formatting throughout the application

Code Organization

• Extracted large methods into smaller, focused helpers
• Reduced MainWindow complexity (1594 → 1580 lines)
• Improved code readability and maintainability

---

🐛 Bug Fixes

Dashboard Issues Fixed

• ✅ Clean button now appears when items are selected on dashboard
• ✅ Selection summary label properly shows/hides based on selection state
• ✅ Visibility logic improved for better user feedback

Selection State Management

• More consistent selection state across all components
• Fixed edge cases where selection counts were incorrect
• Better synchronization between UI and selection state

---

📊 Technical Details

Files Changed

• app/ui/selection_manager.py - NEW: Selection state management
• app/ui/ui_utils.py - NEW: Common UI utilities
• app/ui/main_window.py - Refactored to use new components
• app/__init__.py - Version bump to 1.3.0
• pyproject.toml - Version bump to 1.3.0

Code Metrics

• Lines Reduced: 14 lines removed from MainWindow
• New Modules: 2 new utility modules added
• Methods Extracted: Multiple helper methods for better organization

---

🚀 Installation

AppImage (Recommended)

# Download
wget https://github.com/paladini/echo-cleaner/releases/download/v1.3.0/EchoCleaner-1.3.0-x86_64.AppImage

# Make executable
chmod +x EchoCleaner-1.3.0-x86_64.AppImage

# Run
./EchoCleaner-1.3.0-x86_64.AppImage

From Source

git clone https://github.com/paladini/echo-cleaner.git
cd echo-cleaner
pip install -r requirements.txt
python3 echo-cleaner.py

---

🔄 Upgrade Notes

If you're upgrading from v1.2.0:

• No breaking changes - all functionality remains the same
• UI looks identical - this is purely a technical improvement release
• Better performance - slightly improved selection state management

---

🙏 Acknowledgments

Thanks to the community for reporting issues and providing feedback!

📝 Full Changelog

See CHANGELOG.md for the complete list of changes.

---

Download: EchoCleaner-1.3.0-x86_64.AppImage

SHA256 Checksum: Will be available after build

Echo Cleaner v1.2.0

🎨 v1.2.0 - Enhanced UI/UX with Smart Interactions

A refined user experience with contextual controls, intelligent badges, and beautiful empty states.

---

✨ Highlights

🎯 Contextual Interface

The UI now adapts to what you're doing:

• Dashboard → Shows "Scan System" button
• Category pages → Shows "Clean Selected" button with smart badge
• Empty categories → Displays beautiful "All Clean!" message

🔘 Smart Selection Badges

Managing selections is now more intuitive:

• Click to toggle all items in a category
• Hover feedback shows available action
• Real-time counting of selected items and size
• Color-coded states: Green (all selected), Blue (partial selection)

✨ Beautiful Empty States

When a category has no items to clean:

• Large sparkle emoji (✨)
• "All Clean!" congratulations message
• Centered, elegant layout
• Headers automatically hide

---

🎨 What Changed

Added

• ✨ Empty state UI for categories with no items
• 🎯 Contextual header buttons (scan on dashboard, clean on categories)
• 📊 Smart selection badge showing count and size
• 🖱️ Clickable category badges to toggle all items
• 💡 Hover feedback on interactive elements
• 🔄 Adaptive UI that hides/shows elements based on context

Improved

• 🧹 Removed clutter: No more awkward toggle button on dashboard
• 🎨 Enhanced badge design with gradients and state colors
• 📐 Better layout organization and spacing
• ⚡ Smoother interactions with proper event handling
• 🎭 Empty state design now center-aligned with consistent styling

Fixed

• 🐛 Badge showing "0 Bytes" instead of actual size
• 🧹 Broom emoji appearing on Dashboard after first scan
• 🖱️ Hover effects causing gray checkbox appearance
• 👁️ Headers showing even when categories are empty

---

📦 Installation

Quick Start (AppImage)

# Download
wget https://github.com/paladini/echo-cleaner/releases/download/v1.2.0/EchoCleaner-1.2.0-x86_64.AppImage

# Make executable
chmod +x EchoCleaner-1.2.0-x86_64.AppImage

# Run
./EchoCleaner-1.2.0-x86_64.AppImage

SHA256 Checksum

49392b3e1a9456c6dece240b230c25411f27a612291d49cb95010bf392945e5f  EchoCleaner-1.2.0-x86_64.AppImage

---

🔗 Links

• 📖 Full Release Notes
• 📝 Changelog
• 🐛 Report Issues
• 💬 Discussions

---

🙏 Thanks

Thanks to everyone who provided feedback on the UI! This release is focused on making Echo Cleaner more intuitive and pleasant to use.

What's Next? v1.3.0 will bring additional cleaning modules and performance optimizations.

Echo Cleaner v1.1.0

Release Date: October 19, 2025

🎉 What's New

Visual Improvements

• 🎨 Professional Logo: Replaced the emoji placeholder with a beautiful, high-quality PNG logo (1024x1024px)
• 📏 Larger Display: Logo size increased from 70x70 to 120x120 pixels for better visibility
• 🖼️ Cleaner Interface: Removed border and background from logo container for a more modern look
• 📱 High DPI Support: Logo now renders perfectly on Retina and 4K displays

Security & Permissions

• 🔒 Automatic Privilege Escalation: Integrated pkexec/sudo for operations requiring root access
• 👁️ Visual Indicators: Items requiring admin privileges are now marked with 🔒 badge
• ⚠️ Smart Permission Handling: Graceful fallback when operations fail due to lack of permissions

Functionality Improvements

• 🔄 Auto Re-scan: System automatically re-scans after cleaning to show updated state
• 📊 Accurate Package Manager Cleaning: Now counts only actual package files, ignoring metadata and lock files
• 🐳 Enhanced Docker Cleaning: Force removal of dangling images that are in use by stopped containers
• 📝 Contextual Messages: Different messages for full success, partial success, or complete failure

Bug Fixes

• Fixed: Package Manager cache showing files after successful cleaning
• Fixed: Docker dangling images not being removed when referenced by stopped containers
• Fixed: Dashboard resetting to zero after cleaning instead of showing updated scan
• Fixed: Missing error reporting for failed cleaning operations

📦 Installation

AppImage (Recommended)

# Download the latest AppImage
wget https://github.com/paladini/echo-cleaner/releases/download/v1.1.0/EchoCleaner-1.1.0-x86_64.AppImage

# Make it executable
chmod +x EchoCleaner-1.1.0-x86_64.AppImage

# Run it
./EchoCleaner-1.1.0-x86_64.AppImage

From Source

git clone https://github.com/paladini/echo-cleaner.git
cd echo-cleaner
git checkout v1.1.0
./scripts/install.sh
python3 app/main.py

🔒 Privilege Requirements

Some operations require administrator privileges:

• Package Manager Cache (APT/DNF/Pacman) - Files in /var/cache/
• System Logs - Files in /var/log/

Echo Cleaner will automatically prompt for your password using pkexec when needed. Items requiring privileges are marked with a 🔒 icon.

📖 Documentation

• Quick Start Guide
• User Guide
• Sudo Permissions Guide
• Development Guide

🙏 Contributors

A big thank you to everyone who contributed to this release!

🐛 Known Issues

None at this time. If you find any issues, please report them on our issue tracker.

📊 Statistics

• Commits since v1.0.0: 25+
• Files changed: 15+
• Lines added: 500+
• Bug fixes: 4 major issues resolved

⬆️ Upgrading from v1.0.0

No breaking changes! Simply download the new version and run it. All your settings and preferences are preserved.

💬 Feedback

We love hearing from you! If you have any questions, suggestions, or feedback:

• 🐛 Report a Bug
• 💡 Request a Feature
• 💬 Join the Discussion

⭐ Support the Project

If you find Echo Cleaner useful, please consider:

• ⭐ Starring the repository
• 🐦 Sharing on social media
• 💖 Sponsoring the project

---

Full Changelog: v1.0.0...v1.1.0

Echo Cleaner v1.0.0

First Stable Release!

We're excited to announce the first stable release of Echo Cleaner - an intelligent system cleaner for Linux with a beautiful, Apple-inspired interface.

✨ What's New in v1.0.0

Core Features

• 🔍 Intelligent System Scanning - Automatically detect reclaimable space
• 🎯 Selective Cleaning - Choose what to clean with category-based selection
• 📊 Visual Statistics - Beautiful cards showing space savings by category
• ⚡ Fast Performance - Multi-threaded scanning and cleaning operations

Cleaning Modules

System Cleaning

• 💾 System Cache Cleaner - Clean ~/.cache and system temp files
• 🗑️ Trash Cleaner - Empty trash with one click
• 📝 Log Cleaner - Remove old log files (30+ days)
• 📦 Package Manager Cleaner - Clean APT, DNF, Pacman caches

Developer Tools Cleaning

• 🐳 Docker Cleaner - Remove orphan images, stopped containers, unused volumes
• ☸️ Kubernetes Cleaner - Clean minikube, kind, kubectl caches
• 📚 Dev Dependencies Cleaner - Clean npm, pip, maven, gradle, cargo, go caches

UI/UX

• 🎨 Modern, minimalist interface inspired by Apple design
• 🌓 Clean color scheme with visual hierarchy
• 📱 Responsive layout
• ✅ Progress indicators and real-time feedback
• 💬 Confirmation dialogs for safety

Distribution

• 📦 AppImage Support - Single-file executable, no installation required
• 🛠️ Make Commands - Developer-friendly build system
• 📝 pyproject.toml - Modern Python dependency management

📥 Installation

Option 1: AppImage (Recommended)

Download EchoCleaner-1.0.0-x86_64.AppImage and run:

chmod +x EchoCleaner-1.0.0-x86_64.AppImage
./EchoCleaner-1.0.0-x86_64.AppImage

Option 2: From Source

git clone https://github.com/paladini/echo-cleaner.git
cd echo-cleaner
make install
make run

🔧 Requirements

• Python 3.10+
• PySide6 (Qt 6)
• Linux (tested on Ubuntu, Debian, Fedora, Arch)

Optional:

• Docker (for Docker cleaning)
• Kubernetes tools (for K8s cleaning)

📊 What Can You Clean?

Typical space savings:

• 💾 System Cache: 100MB - 2GB
• 🐳 Docker: 500MB - 20GB
• 📦 Package Cache: 100MB - 5GB
• 📚 Dev Dependencies: 500MB - 15GB
• 🗑️ Trash: 50MB - 10GB

🐛 Known Issues

• Icon is a placeholder (will be improved in v1.1.0)
• Requires system Python with PySide6 installed

🔮 What's Next?

See our roadmap for upcoming features!

🙏 Thanks

Special thanks to everyone who tested the beta versions and provided feedback!

---

Full Changelog: Initial Release

Download: See assets below ⬇️