Automate Computer Cleanup: Empty Trash and Temp files

Hey team, Darian here. Let’s be honest, nobody enjoys manual cleanup. I remember spending the first 15 minutes of my day just clearing out temp directories and my downloads folder. It felt like digital janitorial work. When I calculated that I was losing over an hour a week to this, I knew there had to be a better, automated way. This small script is the result—it’s a simple automation that reclaims your time so you can focus on what actually matters.

Prerequisites

Before we dive in, make sure you have a few things ready:

• Python 3 installed on your machine.
• Basic comfort with using a command line or terminal.
• A task scheduler. Windows has Task Scheduler built-in, and macOS/Linux have cron.
• The send2trash Python library.

The Guide: Step-by-Step

Step 1: Setting Up Your Environment

First things first, let’s get our project ready. I’ll skip the standard virtualenv setup since you likely have your own workflow for that. The main dependency you’ll need is the send2trash library. You can get it using pip. I highly recommend this library because it moves files to the system’s trash or recycle bin instead of permanently deleting them—a much safer default for any automated script.

Step 2: The Python Script – Understanding the Logic

Our script will do two key things:

1. Clean the system’s temporary directory: This is where applications dump files they only need for a short time. Over time, it can get bloated.
2. Clean the Downloads folder: My Downloads folder is a notorious black hole. This part of the script will find files older than a set number of days and move them to the trash, giving you a chance to recover them if needed.

We’ll use Python’s built-in os, pathlib, and tempfile modules for this, along with send2trash.

Pro Tip from Darian: In my production setups, I always add robust logging. Instead of just using print() statements, I configure Python’s logging module to write to a file. This gives you a clear audit trail of what was deleted and when, which is invaluable if you ever need to troubleshoot.

Step 3: The Code Itself

Here’s the full script. I’ve added comments to explain each part. You can save this as something like cleanup_script.py.

import os
import tempfile
import time
from pathlib import Path
from send2trash import send2trash

# --- Configuration ---
# How old a file in Downloads must be (in days) to be moved to trash.
DAYS_OLD_THRESHOLD = 30

def clean_temp_directory():
    """
    Iterates through the system's temp directory and removes files and folders.
    Includes error handling for files that are currently in use.
    """
    temp_dir = tempfile.gettempdir()
    cleaned_count = 0
    error_count = 0
    print(f"\n--- Starting Temp Directory Cleanup of: {temp_dir} ---")

    for item_name in os.listdir(temp_dir):
        full_path = os.path.join(temp_dir, item_name)
        try:
            # Use send2trash for safety, even in temp
            send2trash(full_path)
            print(f"Moved to trash: {item_name}")
            cleaned_count += 1
        except OSError as e:
            # This usually happens if a file is in use by another program
            print(f"Could not remove {item_name}: {e}")
            error_count += 1
    
    print(f"--- Temp Cleanup Complete. Cleaned: {cleaned_count}, Errors: {error_count} ---")
    return

def clean_downloads_folder(days_old):
    """
    Moves files in the user's Downloads folder older than `days_old` to the trash.
    """
    # Path.home() is a reliable way to get the user's home directory
    downloads_path = Path.home() / "Downloads"
    moved_count = 0
    
    if not downloads_path.exists():
        print(f"Downloads folder not found at: {downloads_path}")
        return

    print(f"\n--- Starting Downloads Cleanup (older than {days_old} days) ---")
    
    # Calculate the cutoff time
    cutoff_time = time.time() - (days_old * 86400) # 86400 seconds in a day

    for item in downloads_path.iterdir():
        try:
            # Get the file's last modification time
            mod_time = item.stat().st_mtime
            if mod_time < cutoff_time:
                print(f"Moving to trash: {item.name}")
                send2trash(str(item))
                moved_count += 1
        except Exception as e:
            print(f"Error processing {item.name}: {e}")

    print(f"--- Downloads Cleanup Complete. Moved {moved_count} items to trash. ---")
    return

def main():
    """Main function to run the cleanup tasks."""
    print("Starting automated computer cleanup...")
    clean_temp_directory()
    clean_downloads_folder(DAYS_OLD_THRESHOLD)
    print("\nAll cleanup tasks finished.")

if __name__ == "__main__":
    main()

Step 4: Scheduling the Automation

A script is only useful if you don’t have to remember to run it. Here’s how to put it on a schedule:

• On Linux or macOS (using cron): You can set up a cron job. Open your terminal and set up a new job that points to your script. For example, to run it every Monday at 2 AM, the cron entry would look something like this. You’d use the command line to edit your cron file and add this line.

  0 2 * * 1 python3 script.py

• On Windows (using Task Scheduler): Search for “Task Scheduler” in the Start Menu. Create a new “Basic Task,” give it a name, and set the trigger (e.g., “Weekly” on Mondays at 2:00 AM). For the “Action,” select “Start a program.” In the “Program/script” box, put the full path to your python.exe executable, and in the “Add arguments” box, put the full path to your cleanup_script.py.

Common Pitfalls (Where I Usually Mess Up)

I’ve made a few mistakes setting this up in the past. Here are the big two:

1. Permissions Errors: The most common issue is the script trying to delete a locked file in the temp directory. This is exactly why the try...except block is in the code. It prevents the entire script from crashing just because one file is in use. Don’t skip the error handling!
2. Being Too Aggressive in Downloads: When I first wrote this, I set my DAYS_OLD_THRESHOLD to 7 days. I quickly realized I had trashed a file I needed for a presentation. My personal rule now is to set it to at least 30 days. This gives me a full month to realize I need something and move it to a permanent folder before the script cleans it up.

Conclusion

And that’s it. With a fairly simple Python script and a scheduler, you’ve automated a tedious task, reduced digital clutter, and reclaimed a bit of your week. It might seem like a small thing, but these little workflow optimizations compound over time. They free up your mental energy for the complex problems we’re here to solve. Happy automating!

Darian Vance

Lead Cloud Architect & DevOps Strategist

With over 12 years in system architecture and automation, Darian specializes in simplifying complex cloud infrastructures. An advocate for open-source solutions, he founded TechResolve to provide engineers with actionable, battle-tested troubleshooting guides and robust software alternatives.

🤖 Frequently Asked Questions