Skip to content
This repository was archived by the owner on Sep 27, 2026. It is now read-only.

Latest commit

 

History

45 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WrecksFileCleaner

Unmaintained. This project is no longer developed and the repository is archived. It may still work, but issues and pull requests will not be answered.

WrecksFileCleaner is a Python application designed to automatically clean up your Downloads folder(s) at Windows Startup by deleting

  • every archive that has already been extracted in the same folder
  • files and folders older than a specified number of days (default is 14)

At Windows Startup, WrecksFileCleaner will start in the background, clean your Download folders if necessary or show a summary notification, then close itself. No background resources are wasted for this process.

Download folders, Archive filetypes and the max age in days can be configured in config.ini
A wfc.log is automatically created, clicking the notification opens up the log.

Clean Notification (when there's something to delete at startup):

deletetion

Summary Notification (when there's nothing to delete at startup):

summary

Example Folder and Log

Before After
Before After

image

Features

  • Automatically starts with Windows (configurable)
  • Deletes archive file types if a folder with the same name already exists in the same directory
  • Removes files and folders older than a specified number of days
  • Generates a summary notification of the cleanup process
  • Logs all deleted items for reference

Configuration

  1. Open the config.ini file in a text editor.
  2. Customize the settings according to your requirements:
    • Define paths to clean in SEARCH_PATHS (seperated by comma)
    • Set which extractable extensions to look for in EXTRACTABLE_EXTENSIONS
    • Set the maximum age (in days) for files and folders in the DAYS_UNTIL_DELETION section.
    • Set START_WITH_WINDOWS to true or false to control whether the application starts with Windows.
    • Define the max file size of the log file in MAX_LOG_SIZE_MB
  3. Save the changes to config.ini.

Usage

  • Double-click on WrecksFileCleaner.exe to run the application.
  • The application will automatically clean up the specified paths based on the configured rules.
  • A summary notification will be displayed after the cleanup process.
  • Check the wfc.log file for a detailed record of the deleted items.

Compatibility

  • WrecksFileCleaner is compatible with Windows operating systems.

Security Note

  • Due to the nature of its functionality, some antivirus software may flag WrecksFileCleaner as potentially harmful. However, rest assured that it is an open-source project and does not contain any malicious code.

Contributing

  • Contributions are welcome! If you encounter any issues or have suggestions for improvements, please open an issue or submit a pull request.

About

WrecksFileCleaner is a Python application designed to clean files in specified folders based on age or extraction

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages