# Rename Workspace

The main Rename workspace in RenameClick — a powerful batch file renamer and sorter powered by AI content analysis on Mac and Windows.

## [Adding Files](/content/docs/features/rename-workspace#adding-files/index.html)

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](/content/docs/features/rename-workspace#folder-scanning-options/index.html)

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](/content/docs/features/rename-workspace#processing/index.html)

### [Auto Process Mode](/content/docs/features/rename-workspace#auto-process-mode/index.html)

- **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](/content/docs/features/rename-workspace#how-processing-works/index.html)

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](/content/docs/features/rename-workspace#processing-states/index.html)

| State      | Meaning                                                   |
|------------|-----------------------------------------------------------|
| Pending    | Waiting in the queue                                      |
| Processing | Currently being analyzed by AI                             |
| Completed  | Successfully got a suggested name                         |
| Failed     | Error during processing (can retry)                       |
| Unchanged  | AI suggested the same name as original                    |
| Cancelled  | Processing was stopped by user                             |

## [Reviewing Results](/content/docs/features/rename-workspace#reviewing-results/index.html)

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](/content/docs/features/rename-workspace#statistics-bar/index.html)

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

## [Editing Before Apply](/content/docs/features/rename-workspace#editing-before-apply/index.html)

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](/content/docs/features/rename-workspace#applying-changes/index.html)

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](/content/docs/features/rename-workspace#important-behaviors/index.html)

- **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](/content/docs/features/rename-workspace#undo--redo/index.html)

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](/content/docs/features/rename-workspace#header-controls/index.html)

| Control   | Function                                                    |
|-----------|-------------------------------------------------------------|
| **Provider**     | Select AI provider (Local, OpenAI, Google, etc.)        |
| **Format**       | Choose output filename format or custom pattern         |
| **Language**     | Select output language for generated names (14 languages)|
| **Prompt**       | Use default or custom instructions                       |
| **Rename / Categorize** | Toggle rename only, categorize only, or both    |
| **Auto Process**  | Toggle automatic processing on file drop               |
| **Recursive**     | Toggle recursive folder scanning                        |

## [Rename + Categorize Modes](/content/docs/features/rename-workspace#rename--categorize-modes/index.html)

| Mode                 | What Happens on Apply                                    |
|----------------------|---------------------------------------------------------|
| **Rename only**      | Files are renamed in their current location             |
| **Categorize only**  | Files keep their name but are moved to category folders |
| **Rename + Categorize** | Files are renamed AND moved to category folders        |

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