Python Script Library

Organize Duplicates Finder

🗒️ Python Version: 3.10+

📦 Required Addons: None (built-in modules only)

📝 Description: This script scans the base directory for folders and ZIP files with duplicate base names, compares timestamps, and generates a duplicates_report.txt listing all matches.

import os
from collections import defaultdict

def get_file_timestamp(path):
    """
    Returns the creation date (Windows) or last modified date (Unix)
    as a timestamp for comparison.
    """
    try:
        return os.path.getctime(path)
    except Exception:
        return os.path.getmtime(path)

def find_combined_duplicates(base_dir):
    combined_dict = defaultdict(list)
    for item in os.listdir(base_dir):
        item_path = os.path.join(base_dir, item)
        if os.path.isdir(item_path):
            folder_name = item.lower()
            combined_dict[folder_name].append((item_path, get_file_timestamp(item_path)))
            for subitem in os.listdir(item_path):
                subitem_path = os.path.join(item_path, subitem)
                if os.path.isdir(subitem_path):
                    subfolder_name = subitem.lower()
                    combined_dict[subfolder_name].append((subitem_path, get_file_timestamp(subitem_path)))
                elif os.path.isfile(subitem_path) and subitem.lower().endswith('.zip'):
                    zip_name = subitem[:-4].lower()
                    combined_dict[zip_name].append((subitem_path, get_file_timestamp(subitem_path)))
    duplicates_combined = {name: items for name, items in combined_dict.items() if len(items) > 1}
    report_path = os.path.join(base_dir, 'duplicates_report.txt')
    with open(report_path, 'w') as report_file:
        report_file.write("Combined Duplicate Folders & ZIP Files:\n")
        report_file.write("=========================================\n\n")
        if duplicates_combined:
            for name, items in duplicates_combined.items():
                report_file.write(f"Name: '{name}'\n")
                newest = max(items, key=lambda x: x[1])
                for path, _ in items:
                    flag = " (Newest)" if path == newest[0] else ""
                    report_file.write(f"  - {path}{flag}\n")
                report_file.write("\n")
        else:
            report_file.write("No combined duplicates found.\n")
        report_file.write("\n=========================================\n")
        report_file.write("This script was made by GamerDesigns\n")
        report_file.write("Support: https://www.patreon.com/gamerdesigns\n")
    print(f"✅ Combined duplicate report saved to: {report_path}")

if __name__ == "__main__":
    base_directory = os.path.dirname(os.path.abspath(__file__))
    find_combined_duplicates(base_directory)