Skip to content

emanuele-tarchi-it/python-safe-bulk-renamer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Python Bulk File Renamer

Version License Python

A robust and safe command-line utility to rename multiple files at once. Designed with a "Safety First" approach for professionals managing large datasets, photos, or documents.

🚀 Key Features

  • Dry Run Mode: Preview all changes before they are actually applied to your files.
  • Collision Protection: Automatically skips renaming if the target filename already exists to prevent data loss.
  • Extension Filtering: Choose to rename only specific file types (e.g., only .jpg or .pdf).
  • Flexible Logic: Add prefixes, suffixes, or perform text replacement within filenames.

🛠 How to Use

  1. Clone the repository to your local machine.
  2. Open renamer.py.
  3. Configure the rename_files function parameters in the if __name__ == "__main__": block:
    • folder_path: The directory containing your files.
    • prefix / suffix: Text to add at the start or end.
    • target_ext: Filter by extension (e.g., ".txt").
    • dry_run: Set to True for testing, False for execution.
  4. Run the script: python renamer.py

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.


Developed by Emanuele Tarchi | Automation Specialist Portfolio

About

A professional Python utility for safe bulk file renaming. Features dry-run mode, collision protection, and extension filtering. Perfect for organizing large datasets

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages