Skip to content

3boodMMVI/File-Cleaner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“ File Cleaner

A sleek, automated desktop file organizer for Windows. File Cleaner continuously watches your Downloads (or any target folder) and instantly routes files to specific destinations based on rules you create. Unlike basic organizers, it features Deep Content Scanning, allowing it to read inside PDFs and Word documents to sort them even if the filename is vague.

✨ Features

  • πŸ” Deep Content Search: Reads the actual text inside .pdf, .docx, and .txt files to find keywords for routing.
  • 🍎 Minimalist UI: A clean, modern interface built with customtkinter.
  • ⚑ Real-Time Monitoring: Uses watchdog to detect and move files the instant they are saved.
  • πŸ‘» System Tray Integration: Runs silently in the background. Double-click the tray icon to wake or sleep the app.
  • 🧠 Smart Resume: Prevents duplicate instances. Opening the app while it's hidden just brings the existing window to the front.
  • πŸ“… Auto-Scan Scheduler: Set it to clean your folders Daily, Weekly, or Monthly automatically.

πŸš€ How to Download & Run

No coding required!

  1. Go to the Releases page on the right sidebar.
  2. Download the latest FileCleaner.exe.
  3. Double-click to run. (You might need to tell Windows it's safe to run since it's a new app).

πŸ› οΈ For Developers (Build from Source)

If you want to tweak the code or build it yourself:

  1. Clone the repo

    git clone [https://github.com/3boodMMVI/File-Cleaner.git](https://github.com/3boodMMVI/File-Cleaner.git)
    cd File-Cleaner
  2. Install Dependencies

    pip install customtkinter watchdog pystray schedule pypdf python-docx pillow
  3. Run the Script

    python Main.py
  4. Compile to .exe

    python -m PyInstaller --noconsole --onefile --icon=icon.ico --add-data "icon.ico;." --collect-all customtkinter Main.py

Enjoying the tool? Buy me a coffee to support future updates! β˜•

About

A clean, automated desktop file organizer for Windows. It uses deep content scanning (reading inside PDFs & Docs) to instantly route files to the correct folders.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors