How m00nlygreat/renamer works
Project type and purpose
• This is a command-line, open-source utility written in Python (packaged via PyInstaller) that performs bulk file and folder renaming, moving, or deletion based on instructions provided in an Excel spreadsheet.
File structure
• Top level:
• makelist.py – CLI script that scans a target directory (and subdirectories) and exports all file/folder metadata into an Excel file (renamer.xlsx).
• renamer.py – CLI script that reads an Excel file (default renamer.xlsx or user-supplied) and performs actions (rename, move, delete) on files/folders accordingly.
• README.md, LICENSE, .gitignore – project docs/config.
• No subdirectories or services—this is a simple, monolithic CLI tool.
README for additional insights
• Workflow:
1. Run makelist.exe (or python makelist.py) → generates renamer.xlsx.
2. User edits the Excel file.
3. Run renamer.exe (or python renamer.py) → applies changes to filesystem.
4. Optionally use renamer -u to reverse the last changes (where possible).
• Key behaviors: create missing target directories, delete when both name & path are blank, ignore invalid rows.