Repolode
Submit
yqxie1991

yqxie1991/WxCleaner

A desktop tool for finding and safely removing duplicate files in WeChat's received-file folders, moving them to the system trash.

View on GitHubWebsite
Stars
1,208
Forks
120
Open issues
7
Last commit
2 months ago

What is it?

WxCleaner is a lightweight desktop app built to clean up files that WeChat saves on your computer. It scans a chosen folder, groups files that are identical, and lets you review and delete the extras from a graphical interface.

Duplicate detection runs in three stages: files are first grouped by size, then compared using a partial hash of their headers, and only then confirmed with a full-content hash. This keeps disk reads low while still identifying true duplicates. The results table shows each file's path, size, modification time and status, supports sorting by column, and can open a file's location in the system file manager. Duplicates are pre-marked for removal, keeping the file with the shortest path by default.

Deletion goes through send2trash, so files are moved to the Recycle Bin or Trash rather than erased permanently. The app is built with Python and ttkbootstrap on Tkinter, runs on Windows, macOS and Linux from source, and a single-file Windows executable is available from the releases page.

Key features

  • 01Three-stage scanning: size filter, partial hash, then full hash to confirm duplicates.
  • 02Moves selected files to the system Recycle Bin or Trash instead of deleting them permanently.
  • 03Results table with sorting by column and right-click to open a file's location.
  • 04Automatically marks duplicates for removal, keeping the shorter path by default.
  • 05Light and dark themes, with runs on Windows, macOS and Linux.

Use cases

  • Freeing disk space taken up by repeated images, videos and documents received through WeChat.
  • Reviewing duplicate groups before deleting, with the option to open each file to check its contents.
  • Cleaning a WeChat download or file folder on a Windows, macOS or Linux machine.

Quick start

  1. 1

    Download the Windows executable from the Releases page

  2. 2

    Clone the repository

    git clone https://github.com/yqxie1991/WxCleaner.git
  3. 3

    Create a virtual environment and install dependencies

    pip install -r requirements.txt
  4. 4

    Run the program

    python main.py

Things to know

  • Requires Python 3.8 or higher when running from source.
  • On macOS and Linux, Python may need Tkinter installed separately.
  • The tool deletes files by moving them to the system trash, so reviewing results before cleaning is advised.

Topics

#duplicate-finder#file-cleanup#wechat#tkinter#python#desktop-app#hashing#cleaner#ttkbootstrap#windows

FAQ

What is WxCleaner?
A desktop tool for finding and safely removing duplicate files in WeChat's received-file folders, moving them to the system trash. WxCleaner is a lightweight desktop app built to clean up files that WeChat saves on your computer. It scans a chosen folder, groups files that are identical, and lets you review and delete the extras from a graphical interface.
Is WxCleaner free to use? What license does it have?
WxCleaner is open source under the MIT license. Check the license terms before using it in commercial products.
Is WxCleaner still maintained?
Updated within 6 months. The last commit to WxCleaner was on Aug 20, 2026.
What can I use WxCleaner for?
Freeing disk space taken up by repeated images, videos and documents received through WeChat. Reviewing duplicate groups before deleting, with the option to open each file to check its contents. Cleaning a WeChat download or file folder on a Windows, macOS or Linux machine.
How do I install WxCleaner?
Download the Windows executable from the Releases page Clone the repository: git clone https://github.com/yqxie1991/WxCleaner.git Create a virtual environment and install dependencies: pip install -r requirements.txt Run the program: python main.py
Where can I get WxCleaner?
The source code and installation instructions are on GitHub: https://github.com/yqxie1991/WxCleaner

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects