Skip to content

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

Notifications You must be signed in to change notification settings

wrecks-code/WrecksFileCleaner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WrecksFileCleaner

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.