The Batch File Renaming Tool is a user-friendly application that allows you to rename multiple files in a folder quickly and easily. It provides a graphical user interface for easy configuration and execution of batch file renaming operations.
- Select source folder through a graphical interface
- Two main renaming options:
- Add prefix and/or suffix
- Swap characters in file names
- Real-time preview of file name changes
- Intuitive file selection with checkboxes and Select All/Deselect All buttons
- Resizable sections for better file management
- Undo functionality to revert changes
- Modern, Swiss Design-inspired color scheme for improved readability and aesthetics
- Error reporting for easier troubleshooting
- Splash screen for a polished startup experience
- Detailed logging for better diagnostics and troubleshooting
- Enhanced UI with resizable file list and preview sections
- Improved file selection with intuitive checkboxes
- Added Select All/Deselect All buttons for faster file selection
- Updated button styles for better visibility and contrast
- Optimized UI layout for improved usability
- Added visual feedback for interactive elements
- Added standalone executable packaging with PyInstaller
- Optimized packaging configuration for reduced file size
- Improved application startup performance
- Fixed PyQt6 dependency handling in packaged version
- Enhanced error handling for file system operations
- Python 3.6 or higher
- PyQt6
-
Clone this repository or download the source code.
-
Install the required dependencies:
pip install -r requirements.txt
To run the Batch File Renaming Tool, execute the following command in the project directory:
python ui_main.py
This will launch the application with a splash screen, followed by the main graphical user interface. From here, you can:
- Wait for the splash screen to complete its initialization process
- Click "Browse" to select a folder containing files to rename
- Use checkboxes to select files for renaming
- Choose your renaming option:
- Add prefix/suffix: Enter text to add before or after file names
- Swap characters: Replace specific characters in file names
- Preview changes in real-time
- Click "Rename Files" to apply changes
- Use "Undo Rename" if needed to revert changes
- Navigate to the
distfolder - Run
BatchRename.exe
The packaged application includes all necessary dependencies and will run on any compatible Windows system without requiring Python or additional installations.
-
Startup: The application displays a splash screen while initializing components.
-
User Interface: The GUI provides an easy way to select the source folder, choose renaming options, and select files for renaming using standard multi-select functionality.
-
Rename Options: Users can choose to add prefixes/suffixes or swap characters in file names.
-
Preview: The application shows a real-time preview of the renamed files before applying changes.
-
Renaming Process: When the user clicks "Rename Files," the application renames the selected files according to the chosen options.
-
Undo Functionality: The "Undo Rename" feature allows users to revert the last renaming operation.
- The application may have difficulty renaming files if there are permission issues or if the files are currently in use by another program.
- Renaming a large number of files simultaneously may take some time, especially on slower systems.
- The undo functionality only works for the most recent renaming operation. Multiple levels of undo are not supported.
- When packaging the application with PyInstaller, some antivirus software may flag the executable as suspicious. This is a false positive due to the way PyInstaller works.
Contributions to the Batch File Renaming Tool project are welcome! Please feel free to submit pull requests, create issues or spread the word.
This project is open-source and available under the MIT License.