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

Option 1 (via Homebrew - Recommended)

Execute the commands below:

brew tap ricardodantas/tap

brew install folder-declutter

Option 2 (via cargo)

Execute the command below:

cargo install folder-declutter

Option 3 (Manual)

Download the latest version for your operating system from our releases page and move the binary to /usr/local/bin.

Scheduling with Cron

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

0 0 * * * 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.