ricardodantas / folder-declutter

A folder declutter program that delete files after some pre-defined time.

Folder Declutter

Folder Declutter is a command-line and library utility written in Rust that helps you free up disk space by automatically deleting files that haven't been modified in a specified number of days.

Supported Operating Systems:

Linux and macOS only. Windows support will be available in version 2.0

How It Works

1. Parameters: The tool accepts two parameters—the target folder path and the file age threshold (in days).
2. Cutoff Calculation: It computes a cutoff time by subtracting the provided number of days from the current system time.
3. File Deletion: The tool then recursively scans the folder and deletes files whose last modified time is older than the cutoff.

Getting Started

Download and Installation

Execute the commands below:

brew tap ricardodantas/tap

brew install folder-declutter

Scheduling with Cron

To automate the cleanup, add the following entry to your crontab:

0 9 * * * folder-declutter --folder ~/Downloads --older-than-days 7

This cron setup will run Folder Declutter daily, removing files in the specified folder that are older than seven days.

License

This project is licensed under the Apache License 2.0.