Skip to content

RELEASE_NOTES.md

Latest commit

 

History

History
257 lines (200 loc) · 8.26 KB

RELEASE_NOTES.md

File metadata and controls

257 lines (200 loc) · 8.26 KB

KiloFilter v2.1.0 - Release Notes

🎯 New Features

Smart Duplicate Deletion with Multiple Strategies

KiloFilter v2.1.0 introduces intelligent duplicate removal with three customizable strategies:

🏆 Three Deletion Strategies

  1. Keep Newest - Retains the most recently modified file from each duplicate group

    • Perfect when you want the latest version
    • Uses file modification timestamp for comparison

  2. Keep Oldest - Retains the oldest file from each duplicate group

    • Useful for archival purposes
    • Preserves the original version

  3. Keep Smallest - Retains the smallest file from each duplicate group

    • Optimizes storage space maximally
    • Ideal when file versions are nearly identical

🔍 Real-Time Preview System

  • Instant Preview: See exactly which files will be deleted before confirming
  • Live Updates: Preview refreshes automatically as you change filters
  • File Size Calculation: Shows total space that will be freed
  • Filter Integration: Works seamlessly with search and size-range filters

🔎 Advanced Duplicate Search & Filtering

  • Filename Search: Find duplicates by partial filename matching
  • Size Range Filtering: Filter duplicates by file size (minimum and maximum)
  • Automatic Deduplication: Smart analysis removes all duplicates from results
  • Real-Time Updates: Results update instantly as you adjust filters

📂 Hierarchical File Organization by Extension

  • Two-Level Directory Structure: Files organized by Category → Extension
  • Automatic Extension Detection: System automatically extracts file extension (JPG, PNG, PDF, etc.)
  • Smart Subfolder Creation: Each file type gets its own dedicated subfolder
  • Example Structure: 
    RESCATE_20260211_1430/
├── Imágenes/
│   ├── JPG/
│   │   ├── photo1.jpg
│   │   └── photo2.jpg
│   ├── PNG/
│   │   └── logo.png
│   └── GIF/
│       └── animation.gif
├── Documentos/
│   ├── PDF/
│   │   └── report.pdf
│   ├── XLSX/
│   │   └── spreadsheet.xlsx
│   └── DOCX/
│       └── letter.docx
└── Videos/
    ├── MP4/
    ├── AVI/
    └── MKV/
  • Improved File Discoverability: Quickly locate files by both category and exact type
  • Unknown Extension Handling: Files without recognized extensions are placed in "UNKNOWN" folder

✨ UI/UX Improvements

Button Emoji Consistency

  • Added emojis to 22+ button labels across all tabs
  • Improved visual hierarchy and recognition
  • Consistent icon usage throughout the application
  • Enhanced accessibility with visual cues

Interface Refinements

  • Optimized list view column widths for better visibility
  • Removed redundant "Preview Delete" button (preview now automatic)
  • Streamlined Tab 3 (Search & Filter) layout
  • Better spacing and alignment across all forms

🌍 Localization Updates

All new features are fully translated in 6 languages:

  1. English - Complete localization of all new strings
  2. Spanish - Soporte completo en español
  3. French - Support complet en français
  4. German - Vollständige Unterstützung auf Deutsch
  5. Italian - Supporto completo in italiano
  6. Japanese - 日本語への完全な対応

New Localization Keys (40+ total):

  • Smart deletion strategy labels and descriptions
  • Filter criteria labels (filename, size range)
  • Button labels with emojis
  • Result summary messages
  • Help text for new features

🛠️ Technical Details

SmartDuplicateDeleter Class

  • Location: Core/SmartDuplicateDeleter.cs
  • Responsibility: Implements intelligent duplicate filtering and deletion logic
  • Key Methods:
    • FilterDuplicates(files, strategy) - Applies deletion strategy
    • GetFilesToDelete(files, strategy) - Returns files marked for deletion
    • FormatSize(bytes) - Human-readable file size formatting

Algorithm Enhancements

  • Multi-Stage Filtering:

    1. Group by file size
    2. Compare partial hashes (first 64KB)
    3. Full BLAKE3 hash comparison
    4. Apply selected deletion strategy
    5. Calculate space to be freed

  • Performance Optimization: Full hashes computed only for files with matching partial hashes

Data Persistence

  • Cache system for duplicate detection results
  • JSON serialization of analysis data
  • File extension and category classification

📊 How to Use Smart Duplicate Deletion

Basic Workflow

  1. Click "Analyze Duplicates" on the main tab to scan for duplicates
  2. Go to Tab 3 (Search & Filter) for advanced options
  3. (Optional) Narrow results:
    • Enter filename search terms
    • Set minimum and maximum file size
    • Click "Apply Filters" to update preview
  4. Select a 📋 Deletion Strategy (Keep Newest, Keep Oldest, or Keep Smallest)
  5. Review the Real-Time Preview showing:
    • Files to be deleted (marked with ❌)
    • Total space that will be freed
    • Number of files in each deletion group
  6. Click "❌ Smart Delete" to execute the deletion
  7. Confirm the deletion in the prompt dialog

Advanced Filtering

  • Search Example: Enter ".log" to find duplicate log files only
  • Size Range: Filter duplicates between 1MB and 100MB
  • Multiple Criteria: Combine filename search + size range for precise results
  • Preview Updates: Changes apply instantly—no need to re-analyze

Strategy Selection Guide

Strategy Best For Example
Keep Newest Current versions Keep latest build artifacts
Keep Oldest Archival Preserve original documents
Keep Smallest Storage optimization Multiple copies of media files

🔄 Comparison: Old vs. New

Before v2.1.0

  • Manual duplicate selection required
  • No preview of consequences
  • Single deletion behavior
  • Limited filtering options

After v2.1.0

  • ✅ Automatic deletion strategy selection
  • ✅ Real-time deletion preview
  • ✅ Three customizable deletion strategies
  • ✅ Advanced filtering (name + size range)
  • ✅ Space calculation before deletion
  • ✅ Consistent emoji-based UI

📋 System Requirements

  • .NET Runtime: 8.0 (Windows)
  • Operating System: Windows 7 or later (x86, x64, ARM64)
  • RAM: 256MB minimum (1GB recommended)
  • Disk Space: 50MB for application + space for duplicate analysis cache

✔️ Testing Recommendations

  1. Test Smart Deletion Strategies:

    • Create test folder with duplicate files from different dates
    • Try all three strategies and verify correct files are kept

  2. Test Filtering System:

    • Search for specific file types (e.g., ".jpg", ".pdf")
    • Apply various size ranges
    • Verify preview updates in real-time

  3. Test Edge Cases:

    • Empty duplicate groups
    • Very large files (>1GB)
    • Mixed file types and sizes
    • Network-mounted folders

  4. Performance Testing:

    • Analyze folders with 10,000+ files
    • Measure hash computation time
    • Verify memory usage remains stable

🐛 Known Limitations

  • Preview shows up to 1,000 files at a time (rarely exceeded in practice)
  • BLAKE3 hashing may take several seconds for very large files (>1GB)
  • Network drives have slower performance due to I/O delays

📝 Upgrade Notes

Breaking Changes: None - v2.1.0 is fully backward compatible with v2.0.0

Migration Path:

  1. Uninstall v2.0.0 (optional - new version can coexist)
  2. Install v2.1.0
  3. Existing configuration files are automatically imported
  4. Start using Smart Deletion features immediately

Configuration Files:

  • Settings are stored in user's AppData folder
  • Previous settings are automatically migrated
  • No manual configuration required

🎓 Educational Resources

For detailed usage instructions, see:

  • README.md - Feature overview and installation guide
  • CHANGELOG.md - Complete version history
  • In-App Help - Tab 4 contains context-sensitive help

📞 Support & Feedback

For issues, feature requests, or feedback:

  1. Check the FAQ in the Help tab
  2. Review CHANGELOG.md for known issues and solutions
  3. Consult the technical details section above

Version: 2.1.0 Release Date: February 15, 2026 Status: Stable Build: .NET 8.0-windows