Rename Workspace

Adding Files

There are three ways to add files:

1. Drag & Drop — Drag files or folders directly onto the drop zone
2. Browse — Click the browse button to open the system file picker
3. Right-Click — Right-click files/folders in Finder (macOS) or Explorer (Windows) and choose "Rename with RenameClick"

Folder Scanning Options

When you add a folder:

• Non-recursive (default): Only processes files directly inside the folder
• Recursive: Processes files in the folder and all subfolders

Toggle recursive scanning in the workspace header.

Processing

Auto Process Mode

• Auto Process ON: AI analysis starts immediately when files are dropped
• Auto Process OFF: Files are added as pending; you manually click Run AI when ready

How Processing Works

1. Files are queued and processed one at a time (sequential processing)
2. The AI model analyzes each file's content:
   • Images: The AI "sees" the image and describes what's in it
   • Documents: The AI reads extracted text and understands the document type and content
3. For each file, the AI generates:
   • A suggested filename (when Rename is enabled)
   • A category assignment (when Categorize is enabled)
4. Processing can be stopped at any time and resumed later
5. Failed files can be retried individually or all at once

Processing States

Reviewing Results

After processing, the results panel shows for each file:

• Original filename
• AI-suggested new filename (editable)
• Category suggestion (if categorize is enabled)
• File size
• Processing time
• Success/error/unchanged status indicator

Statistics Bar

• Processed / Total files count
• Total file size
• Total processing time

Editing Before Apply

You can fine-tune results before applying:

• Edit individual names — Click on any suggested name to modify it
• Find & Replace — Search and replace text across all generated names
  • Match Case option
  • Match Whole Word option
  • Regex support
  • Navigate between matches
  • Replace one or Replace All
• Deselect rows — Uncheck files you don't want to rename
• Retry failures — Re-process files that had errors

Applying Changes

1. Select files using individual checkboxes or "Select All"
2. Click Rename Selected (or "Rename & Move" / "Move to folder" if categorization is active)
3. Files are renamed/moved on disk

Important Behaviors

• Nothing changes until you click Apply — AI analysis only creates suggestions
• Original extensions are preserved — .pdf stays .pdf, .jpg stays .jpg
• Duplicate names are auto-resolved — If a target name exists, the app appends _1, _2, etc.
• Invalid characters are sanitized — Characters like /, \, :, *, ?, ", <, >, | are removed
• Clear workspace after apply — Optional toggle to clean the workspace after each apply. (Clear by default)

Undo / Redo

After applying renames:

• Undo — Reverts the last rename operation (files are moved back to their original names/locations)
• Redo — Re-applies a reverted rename

Undo/redo works only for applied renames.

Header Controls

Rename + Categorize Modes

When categorization is enabled, applying creates subfolders named after the assigned categories inside the destination folder.