Flattens all files from subdirectories into a single base folder. This is helpful when your backups or exports are nested in many useless folders.

flatten_folder.py

import os
import shutil

# Set your base folder here
base_folder = "/path/to/target/folder"

# Walk through all subdirectories (bottom-up to safely remove them)
for root, dirs, files in os.walk(base_folder, topdown=False):
    for file in files:
        # Skip hidden/system files
        if file.startswith("._"):
            continue

        file_path = os.path.join(root, file)
        dest_path = os.path.join(base_folder, file)

        # Handle name conflicts by appending a number
        counter = 1
        while os.path.exists(dest_path):
            name, ext = os.path.splitext(file)
            dest_path = os.path.join(base_folder, f"{name}_{counter}{ext}")
            counter += 1

        # Move the file to the base folder
        shutil.move(file_path, dest_path)
        print(f"Moved {file} to {base_folder}")

    # Try to remove the now-empty folder (but not the base folder)
    if root != base_folder:
        try:
            os.rmdir(root)
            print(f"Removed empty folder: {root}")
        except OSError:
            print(f"Could not remove folder (not empty?): {root}")