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
SelectionManagercomponent - 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
MainWindowcomplexity (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 managementapp/ui/ui_utils.py- NEW: Common UI utilitiesapp/ui/main_window.py- Refactored to use new componentsapp/__init__.py- Version bump to 1.3.0pyproject.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.AppImageFrom 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