Short repository description:
A safe, GUI-based PowerShell tool for bulk file and folder refactoring, with optional previewed content modifications and full undo support.
Mass File Refactor (MFR) is a Windows GUI application written in PowerShell that provides a controlled and reversible way to perform large-scale file and folder refactoring.
This project was formerly known as “Mass File Renamer” and has since expanded beyond naming operations to include a broader refactoring workflow, while preserving a strict preview-first, opt-in execution model.
No changes are ever made automatically — every operation is previewed and must be approved before execution.
- Recursive directory processing
- Rename folders
- Rename files
- Rename file extensions
- Automatic title formatting
- Replace character(s) or strings
- Append character(s):
- At the beginning
- At the end
- Before specific character(s)
- After specific character(s)
- Replace character(s):
- At the start
- At the end
- Delete character(s):
- Before specific character(s)
- After specific character(s)
- Insert character(s) at a specific position
- Increment numbers
- Pad numbers (e.g.
001,002) - Remove non-Latin / Unicode characters
- Convert names to lower case
- Convert names to upper case
- Add spaces to CamelCase file names
(Disabled by default and only applied when explicitly selected)
- Search and replace text inside file contents
- Filter by file type / extension
- File size limits to prevent unintended large edits
- Encoding control (Auto or explicit)
- Full preview of content changes before execution
- Patch-based undo support with validation
MFR is designed to be conservative and predictable:
- Preview-first workflow
- No implicit actions
- Undo support for:
- File and folder refactoring
- File content modifications
- Case-safe rename handling on Windows
- Validation and integrity checks for content undo operations
If something does not look correct in the preview, you can exit without changing a single file.
- Download Mass-File-Refactor.zip from GitHub
- Click Code (top-right)
- Select Download ZIP
- Extract the files to a location of your choice
- Right-click MFR.ps1 and select Edit
(This opens the script in PowerShell ISE) - Click the green Play button ▶ in PowerShell ISE
- The GUI will launch and is ready to use
Note: This tool is intended for Windows systems with PowerShell ISE available.
- Select a target directory
- Choose the type of refactor operation(s)
- Configure options (and content options if desired)
- Review the preview output
- Execute changes only if the preview is correct
- Use Undo if you need to revert
Manual refactoring of large file sets is slow, error-prone, and risky.
Uncontrolled bulk scripts are fast — but dangerous.
Mass File Refactor (MFR) provides automation with visibility and reversibility, keeping you in control at every step.