Skip to content

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Batch Renamer

A portable Windows utility that lets users safely rename multiple files at once, preview the results, and place the processed files into a dedicated output folder without modifying the originals.

Features

  • Safe File Processing: Original files are never modified or deleted. Results are copied to a new folder.
  • Drag & Drop / Browse: Easily add files to the queue or remove them individually.
  • Live Preview: See exactly what the new filenames will look like before processing.
  • Flexible Naming Patterns: Use {name}, {number}, prefixes, suffixes, and custom zero-padding.
  • Validation: Detects duplicate names, invalid Windows characters, and inaccessible files before executing.
  • AP / INBOX: Built-in announcement system (DTAP) for developer-to-user communication. Works gracefully offline.

Run from source

  1. Ensure you have Python installed.
  2. Install dependencies:
   pip install -r requirements.txt
  1. Run the application:
   python run.py

(Or just double-click Launch.bat which will automatically set up a virtual environment and run it.)

Build the portable release

  1. Install PyInstaller:
   pip install pyinstaller
  1. Build the executable:
   pyinstaller --name BatchRenamer --onedir --noconsole run.py
  1. Copy your Launch.bat into the newly created dist/BatchRenamer/ folder.
  2. Zip the BatchRenamer folder and distribute it. Users can run it directly without installing Python.

Runtime Data

  • The application stores the renamed files in: C:\Users\<username>\BR_results_<date>\
  • If the folder already exists, it automatically appends _02, _03, etc., to prevent overwriting previous results.
  • The application does not write any other local data or registry keys.

AP / INBOX

The INBOX button connects to a centralized announcement platform (DTAP) via Firebase.

  • It requires an internet connection only to fetch announcements.
  • If offline, it fails gracefully and the core renaming functionality remains 100% operational.
  • The client is strictly read-only.

Disclaimer

This software is provided as-is, without any guarantees or warranty. We are not responsible for any loss, damage, or issues that may arise from using it. By using this software you accept this condition. If you do not agree, please do not use it.

About

A portable Windows utility for safely batch-renaming files.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages