RenameCheetah v1.2.0

A fast, scriptable batch file renaming utility for macOS, Windows, and Linux.

by Richard Lesh

---

Features

• Rename Scripts — Create, duplicate, and manage reusable rename scripts
• 18 Script Step Types — Find & Replace, Remove Text, Add Prefix, Add Suffix, Convert Case, Add Date/Time, Add Sequence Number, Insert at Position, Pad Number, Regular Expression, Replace Spaces, Sanitize, Swap, Trim, Add/Replace Hash, Add Metadata (Audio, Photo, Video)
• Metadata via External Tools — Audio/video metadata via ffprobe, photo metadata via exiftool (auto-detected or configurable paths)
• Drag & Drop — Drop files onto the app or the macOS dock icon to preview renames instantly
• Live Preview — See "Current Name" vs "New Name" side-by-side before committing
• Duplicate Filename Handling — Automatic dedup with case-sensitivity awareness per directory
• Multi-Select — Select multiple files to remove from the list
• Inline Rename — Double-click a filename to rename it immediately
• Drag-Reorderable Steps — Reorder script steps by dragging
• Sortable File List — Sort by current or new name, ascending or descending
• Resizable Panels — Drag dividers to adjust panel and column widths
• Persistent Layout — Window size, position, and divider positions saved between sessions
• Auto-Save — Scripts auto-save on a configurable interval (default 120s)
• Context Menu — Right-click files for Remove, Add Files, or Clear Files
• Configurable — Row colors, selection highlight color, tool paths, and auto-save interval via settings
• Cross-Platform — macOS, Windows, and Linux builds via electron-builder
• Code Signing — macOS code signing and Windows Azure Artifact Signing support
• License Key — HMAC-SHA256 based license key system with splash nag for unlicensed users

---

Installation

Prerequisites

• Node.js (v22 or later)
• npm

Setup

git clone https://github.com/richlesh/RenameCheetah.git
cd RenameCheetah
npm install

Running

npm start

---

Building Distribution Packages

# All platforms and architectures
npm run dist:all

# Individual builds
npm run dist:mac:x64       # macOS Intel
npm run dist:mac:arm64     # macOS Apple Silicon
npm run dist:win:x64       # Windows x64
npm run dist:win:arm64     # Windows ARM64
npm run dist:linux:x64     # Linux x64
npm run dist:linux:arm64   # Linux ARM64

Output files are placed in the dist/ folder.

---

Project Structure

RenameCheetah/
├── main.js              # Electron main process
├── index.html           # Main window (three-panel rename UI)
├── styles.css           # Main window styles
├── settings.html        # Settings window
├── settings.js          # Settings module (load/save)
├── about.html           # About dialog
├── license_dialog.html  # License key entry
├── splash.html          # Splash screen
├── config.json          # App configuration (colors, autosave interval)
├── package.json         # npm/electron-builder config
├── resources/           # App icons (app_icon.png/.icns/.ico, app_icon_256.png)
├── sign-mac.sh          # macOS code signing script
├── User_Manual.md       # User documentation
├── LICENSE              # GPL 3.0 license
└── .github/workflows/   # CI/CD workflows

---

Tech Stack

• Electron

---

License

GNU General Public License v3.0 — see LICENSE for details.

© 2026 Richard Lesh