Python Script for Bulk File Renaming and Organization
Core Concepts and Safety Precautions
Automating file operations requires careful execution. Before running any script that modifies files, it is crucial to:
**Backup Critical Data:** Always create a full backup of the directory you intend to modify.
**Dry Run:** Implement a "dry run" mode in your script first, printing what *would* happen without actually making changes. This helps verify logic.
**Test on Dummy Data:** Test the script on a separate directory with non-essential dummy files.
The Python os module provides functions for interacting with the operating system, including file system operations. The shutil module offers higher-level file operations like moving and copying.
Script 1: Bulk Renaming Files
This script demonstrates how to rename files by adding a prefix and sequential numbering. This pattern can be adapted for date-based renaming, replacing substrings, or other custom logic.
import os
def rename_files_bulk(directory_path, prefix="file_", dry_run=True):
"""
Renames files in a given directory with a specified prefix and sequential numbering.
Args:
directory_path (str): The path to the directory containing the files.
prefix (str): The prefix to add to each filename.
dry_run (bool): If True, prints changes without executing. If False, performs changes.
"""
if not os.path.isdir(directory_path):
print(f"Error: Directory not found at {directory_path}")
return
files = [f for f in os.listdir(directory_path) if os.path.isfile(os.path.join(directory_path, f))]
files.sort() # Ensure consistent ordering
print(f"--- {'DRY RUN' if dry_run else 'EXECUTING'} RENAMING OPERATION ---")
for i, filename in enumerate(files):
name, ext = os.path.splitext(filename)
new_filename = f"{prefix}{i+1:03d}{ext}" # e.g., file_001.txt
old_path = os.path.join(directory_path, filename)
new_path = os.path.join(directory_path, new_filename)
print(f"Renaming: '{filename}' -> '{new_filename}'")
if not dry_run:
try:
os.rename(old_path, new_path)
except OSError as e:
print(f"Error renaming {filename}: {e}")
print("Renaming operation complete.")
--- Configuration ---
Set your target directory here
target_directory = 'C:/Users/YourUser/Documents/MyUnorganizedFiles'
For Linux/macOS: '/home/youruser/MyUnorganizedFiles'
Example Usage:
Run in dry-run mode first to see what changes will be made
rename_files_bulk(target_directory, prefix="ProjectX_Doc_", dry_run=True)
After verifying, change dry_run to False to execute
rename_files_bulk(target_directory, prefix="ProjectX_Doc_", dry_run=False)
To modify renaming logic, adjust the new_filename generation. For instance, to replace spaces with underscores: new_filename = name.replace(' ', '_') + ext. For date-based renaming, you might parse the file's modification time using os.path.getmtime() and datetime.fromtimestamp().
Script 2: Bulk File Organization (Moving to Subdirectories)
This script organizes files by moving them into subdirectories based on their file extension. This approach can be extended to organize by date, file size, or patterns in the filename.
import os
import shutil
import datetime
def organize_files_bulk(directory_path, organize_by='extension', dry_run=True):
"""
Organizes files in a directory into subdirectories based on specified criteria.
Args:
directory_path (str): The path to the directory to organize.
organize_by (str): Criteria for organization ('extension', 'year', 'month').
dry_run (bool): If True, prints changes without executing. If False, performs changes.
"""
if not os.path.isdir(directory_path):
print(f"Error: Directory not found at {directory_path}")
return
print(f"--- {'DRY RUN' if dry_run else 'EXECUTING'} ORGANIZATION OPERATION ---")
for filename in os.listdir(directory_path):
old_path = os.path.join(directory_path, filename)
if os.path.isfile(old_path):
name, ext = os.path.splitext(filename)
target_subdir_name = ""
if organize_by == 'extension':
target_subdir_name = ext[1:].lower() if ext else "no_extension"
elif organize_by == 'year':
mod_time = os.path.getmtime(old_path)
dt_object = datetime.datetime.fromtimestamp(mod_time)
target_subdir_name = str(dt_object.year)
elif organize_by == 'month':
mod_time = os.path.getmtime(old_path)
dt_object = datetime.datetime.fromtimestamp(mod_time)
target_subdir_name = dt_object.strftime("%Y-%m")
else:
print(f"Warning: Unsupported organization criteria '{organize_by}' for {filename}. Skipping.")
continue
target_dir = os.path.join(directory_path, target_subdir_name)
new_path = os.path.join(target_dir, filename)
print(f"Moving: '{filename}' -> '{target_subdir_name}/{filename}'")
if not dry_run:
try:
os.makedirs(target_dir, exist_ok=True) # Create subdir if it doesn't exist
shutil.move(old_path, new_path)
except OSError as e:
print(f"Error moving {filename}: {e}")
print("Organization operation complete.")
--- Configuration ---
Set your target directory here
target_directory = 'C:/Users/YourUser/Documents/MyUnorganizedFiles'
For Linux/macOS: '/home/youruser/MyUnorganizedFiles'
Example Usage:
Run in dry-run mode first
organize_files_bulk(target_directory, organize_by='extension', dry_run=True)
organize_files_bulk(target_directory, organize_by='year', dry_run=True)
After verifying, change dry_run to False to execute
organize_files_bulk(target_directory, organize_by='extension', dry_run=False)
To organize by other criteria, modify the target_subdir_name generation logic. For example, to organize by the first letter of the filename, you could use target_subdir_name = name[0].upper().
Combining Renaming and Organization
The renaming and organization logic can be combined within a single loop. First, determine the new filename, then determine the target subdirectory, create it if necessary, and finally move the file with its new name. Always prioritize the dry run approach to prevent unintended modifications.
Need this done fast? order it on Kwork.
