Skip to content

Releases: ettisafxrup/CleanWrap

CleanWrap v1.2.0

Choose a tag to compare

@github-actions github-actions released this 20 Aug 21:05

🧹 CleanWrap — Smart File Organization for Windows [v1.2.0]

Language
Platform
License
Version

CleanWrap v1.2.0 🎉

🤔 What's New

  • Added staged duplicate detection for faster file organization.
  • Files are filtered by size before any content hashing is performed.
  • Same-size files are compared using a partial hash of their first and last 64 KiB.
  • A complete FNV-1a hash is calculated only when the earlier checks match.
  • Reduced unnecessary disk reads and hashing work for files that cannot be duplicates.

🔄 Periodic Update Checker

  • CleanWrap checks GitHub for a newer release automatically.
  • Update checks run once every seven days instead of on every startup.
  • The check interval is stored in a small file under %LOCALAPPDATA%\\CleanWrap.
  • A version change triggers a fresh check immediately.
  • Network failures do not interrupt file organization.
  • A Windows notification is shown only when a newer version is available.

📰 Project Architectural Logs:

🧩 Centralized Version Management

  • The application version is managed from one shared Version.hpp file.
  • The application, update checker, build script, release script, and installer use the same version.
  • Installer names and release tags can be updated without changing several source files manually.

🛠️ Build and Compatibility Improvements

  • Added the Windows WinHTTP dependency for secure GitHub release checks.
  • Preserved the lightweight, one-shot workflow of the application.
  • Kept update checking non-blocking for offline users through short request timeouts.

📦 Installation

Download the latest installer from the GitHub Releases page:

Download Latest Release

The installer is named CleanWrap_v1.2.0_Setup.exe.

CleanWrap © 2026 • Developed by Ettisaf Rup • Released under the MIT License

CleanWrap v1.0.1

Choose a tag to compare

@github-actions github-actions released this 15 Aug 09:19

🧹 CleanWrap — Smart File Organization for Windows [v1.0.0]

Language
Platform
License
Version

CleanWrap v1.0.1 🎉

🛠️ Patch Updates

  • Fixed Windows startup/runtime compatibility issues.
  • Removed dependency on externally supplied MinGW runtime DLLs for the release build.
  • Improved installer reliability across Windows PCs.
  • Corrected documentation and installed-file organization.
  • Improved the overall release packaging.

📦 Cleaner Installation Directory

The installer has been refined to keep CleanWrap's supporting files organized while keeping the main application easy to access.

Documentation and user files are now separated from the main executable.

⏬ Download CleanWrap_v1.0.1

Download Latest Release

CleanWrap © 2026 • Developed by Ettisaf Rup • Released under the MIT License

CleanWrap v1.0.0

Choose a tag to compare

@ettisafxrup ettisafxrup released this 06 Aug 11:04

🧹 CleanWrap — Smart File Organization for Windows [v1.0.0]

Language
Platform
License
Version
GitHub

CleanWrap v1.0.0 is the first stable release of a lightweight Windows file organization utility built entirely with Modern C++20.

Originally designed for the Windows Downloads folder, CleanWrap can now organize any folder through Windows Explorer integration. It intelligently categorizes files into dedicated folders, detects duplicate files using content hashing and Windows duplicate filename patterns, generates detailed cleanup reports, and exits within seconds.

CleanWrap is designed to stay lightweight, fast, and dependency-free while keeping your directories clean with minimal user interaction.


✨ Features

  • Automatically organizes downloaded files
  • Organizes any folder through Windows Explorer Context Menu
  • Categorizes files by extension
  • Creates category folders only when required
  • Creates duplicate folders only when duplicate files exist
  • Supports documents, images, videos, audio, archives, source code, executables, installers, and many more
  • Detects duplicate files using 64-bit FNV-1a hashing
  • Recognizes common Windows duplicate filename patterns
  • Automatically generates detailed cleanup logs
  • Optional Windows Startup integration
  • Lightweight and extremely fast
  • Modular object-oriented architecture
  • Built entirely using Modern C++20

📂 Folder Structure

After running CleanWrap, your directory is automatically organized like this:

Downloads/

├── Images/
│   └── Duplicates_Images/
│
├── PDFs/
│   └── Duplicates_PDFs/
│
├── Videos/
│   └── Duplicates_Videos/
│
├── Audio/
│   └── Duplicates_Audio/
│
├── Code/
│   └── Duplicates_Code/
│
├── Documents/
│   └── Duplicates_Documents/
│
├── Zips/
│   └── Duplicates_Zips/
│
├── Executables and Installers/
│   └── Duplicates_Executables and Installers/
│
├── Others/
│   └── Duplicates_Others/
│
└── _CleanWrap.log

Note: Category folders are created only when files belonging to that category exist. Likewise, duplicate folders are created only if duplicate files are detected.


🔍 Smart Duplicate Detection

CleanWrap uses a multi-stage duplicate detection system.

① Content-Based Hash Detection

Every file is hashed using a fast 64-bit FNV-1a hashing algorithm.

If another file with the exact same content already exists, CleanWrap identifies it as a duplicate regardless of its filename.


② Windows Duplicate Filename Recognition

CleanWrap also recognizes common Windows duplicate filename patterns such as:

My File (1).pdf
My File (2).pdf
Holiday - Copy.jpg
Assignment - Copy (3).docx

These filename patterns are checked alongside file hashes before classifying a file as a duplicate.


③ Intelligent Duplicate Placement

When duplicate files are found:

  • The original file remains inside its main category folder.
  • Windows-generated copies such as (1) or - Copy are automatically moved into the corresponding Duplicates folder.
  • If identical files have different names, the original file is preserved while later duplicates are isolated.

This keeps your directories clean without risking accidental loss of the original file.


📊 Cleanup Report

Every execution generates:

_CleanWrap.log

The report contains:

  • Date & Time
  • Cleanup session summary
  • Total files handled
  • Category-wise statistics
  • Duplicate count
  • Error count

Logs are appended instead of overwritten, preserving the history of every cleanup session.


⚙ Windows Integration

CleanWrap integrates directly with Windows.

Windows Explorer Context Menu

Right-click inside any folder and choose:

Organize with CleanWrap

CleanWrap instantly organizes the selected directory.


Windows Startup (Optional)

During installation you may enable:

Automatically organize Downloads when Windows starts

CleanWrap launches once during Windows startup, organizes the Downloads folder, generates a cleanup report, and exits automatically.


📦 Project Structure

CleanWrap/

.
├── 📂 assets
│   ├── cleanwrap.ico
│   ├── installer_banner.bmp
│   ├── installer_small.bmp
│   ├── logo.png
│
├── 📂 include
│   ├── DuplicateDetector.hpp
│   ├── FileClassifier.hpp
│   ├── FileOrganizer.hpp
│   ├── FileTypes.hpp
│   ├── Notifications.hpp
│   ├── Statistics.hpp
│
├── 📂 src
│   ├── DuplicateDetector.cpp
│   ├── FileClassifier.cpp
│   ├── FileOrganizer.cpp
│   ├── FileTypes.cpp
│   ├── Notifications.cpp
│   ├── Statistics.cpp
│
├── 📂 release
│   ├── CleanWrap_v1.0
│   │   ├── CleanWrap_v1.0.exe
│   │   ├── CleanWrap_v1.0_Setup.exe
│
├── 📂 script
│   ├── cleanwrap_v1.0.iss
│
├── LICENSE
├── README.md
├── main.cpp
├── release.sh

⚡ Built With

  • Modern C++20
  • Standard Template Library (STL)
  • <filesystem>
  • <unordered_map>
  • <unordered_set>
  • <regex>
  • <fstream>
  • Object-Oriented Programming
  • Modular Project Architecture
  • Windows Registry Integration
  • Windows Explorer Context Menu
  • Inno Setup Installer

📦 Included with CleanWrap v1.0

  • CleanWrap Installer
  • CleanWrap Executable
  • User Manual
  • README
  • Source Code
  • MIT License

🚀 Building Locally

Compile using g++

g++ -O2 -std=c++20 ^
-Iinclude ^
main.cpp ^
src/*.cpp ^
-o CleanWrap.exe

Release build:

./release.sh

🖋 Author

Ettisaf Rup

Software Lead, XtendArena

B.Sc. in Computer Science & Engineering

Khulna University of Engineering & Technology (KUET)

GitHub
LinkedIn
Instagram
Facebook


🤲 Support CleanWrap

If you found this project useful, consider giving it a ⭐ on GitHub.

It helps others discover the project and motivates future improvements.

And if anyone ever wishes to donate, you can always bring me to a tong for a cup of tea. ☕

Download Latest Release

GitHub Stars


🚀 Roadmap

  • Drag & Drop Support
  • Automatic Update Checker
  • Undo Last Organization
  • Configuration File (.json)
  • User-defined Categories
  • SHA-256 Duplicate Detection
  • File Type Icons
  • Statistics Dashboard
  • GUI Version
  • Multi-threaded Processing
  • Localization Support

Thank you for checking out CleanWrap.

If this project helped you organize your files or inspired you, consider leaving a ⭐ on the repository. Every star motivates future development and helps the project reach more people.

Happy organizing! 🧹


CleanWrap © 2026 • Developed by Ettisaf Rup • Released under the MIT License

downTidy v0.1

downTidy v0.1 Pre-release
Pre-release

Choose a tag to compare

@ettisafxrup ettisafxrup released this 06 Aug 04:33

downTidy — Your Download Directory CareTaker [v0.1]

Language Github License Version

downTidy v1.0.0 is the first stable release of a lightweight Windows file organizer built with Modern C++17. It automatically categorizes files into dedicated folders, detects duplicates using file hashing and filename patterns, and generates detailed cleanup logs after every execution. This release establishes the foundation for future features such as Windows context menu integration, drag-and-drop support, automatic updates, and a graphical user interface.
Designed primarily for the Windows Downloads Folder (v1.0), downTidy can sort files in seconds while intelligently handling duplicates and generating cleanup reports.


✨ v1.0 Features

  • Automatically organizes downloaded files
  • Categorizes files by extension
  • Supports documents, images, videos, audio, code files, archives, executables, and more
  • Detects duplicate files using file hashing
  • Places duplicate files into dedicated duplicate folders
  • Generates a cleanup log after every execution
  • Lightweight and fast
  • Modular architecture using multiple C++ classes
  • Built with Modern C++20


🔍 Smart Duplicate Detection

downTidy detects duplicates using:

  • Fast FNV-1a 64-bit File Hashing (built-in C++)
  • Windows duplicate filename patterns:
    • (1)
    • (2)
    • - Copy
    • - Copy (1)

While your directory having multiple copy files, downTidy wipes out all the copy files and puts them in a separated file. And yes, you can delete them later anytime. Duplicate files are automatically moved into dedicated duplicate folders. Every Category having their own dedicated Duplicate folder.


📊 Cleanup Report

Every execution generates:

_downTidy.log

The report contains:

  • Date & Time
  • Files processed
  • Category statistics
  • Duplicate count
  • Error count

Logs are appended instead of overwritten. Newer logs can be found at the last of the file.


📦 Project Structure

downTidy/
.
├── downTidy.exe
│
├── 📂 include
│   ├── DuplicateDetector.hpp
│   ├── FileClassifier.hpp
│   ├── FileOrganizer.hpp
│   ├── FileTypes.hpp
│   ├── Statistics.hpp
│
├── 📂 src
│   ├── DuplicateDetector.cpp
│   ├── FileClassifier.cpp
│   ├── FileOrganizer.cpp
│   ├── FileTypes.cpp
│   ├── Statistics.cpp
│
├── main.cpp
├── README.md



⚡ Built With

  • Modern C++20
  • STL
  • Standard Filesystem Library (<filesystem> | std::filesystem)
  • Object-Oriented Programming (.hpp and .cpp separated)
  • Modular Project Structure

📦 Included with downTidy v1.0

  • downTidy.exe
  • Source Code
  • README

🖋 Author

Ettisaf Rup

Former Technical Lead, ProximaIT

Software Lead, XtendArena

BSc. in Computer Science & Engineering, KUET

Instagram
Linkedin Facebook
Instagram


🤲 Support downTidy

If you found this project useful, consider giving it a ⭐ on GitHub.
It helps others discover the project and motivates future improvements.

and if anyone wills to donate, you can bring me to a tong.

Download Stars


ettisafxrup downTidy@2026 | all rights reserved


🚀 Upcoming Features

  • Right-click "Organize with downTidy" One-Click Formattion.
  • Installer.
  • Run on Windows Startup.
  • Auto Update Checker.
  • Configuration File.
  • GUI Version.
  • SHA-256 Duplicate Detection.

Thank you for checking out downTidy!
If you find the project useful, consider leaving a star (⭐) on the repository.

Thank you.