Tab Renamer

About

### Core Features

- **Smart Grouping**: Use `GroupName-TabName` pattern to organize tabs
- **Unique Colors**: Each group gets a unique color, each tab gets a unique outline
- **Persistent Naming**: Tab names survive page reloads and navigation within same domain
- **Keyboard Shortcuts**: Quick access with `Ctrl+Shift+R` (Windows) or `Cmd+Shift+R` (Mac)
- **Bulk Operations**: Restore single tab or all tabs at once
- **Performance Optimized**: CPU-friendly with batching and debouncing

### 🔧 Advanced Features

- **Domain Tracking**: Names persist within same domain, reset when switching domains
- **Auto-cleanup**: Automatically removes closed tabs from storage
- **Error Handling**: Graceful handling of edge cases and browser limitations
- **Visual Feedback**: Real-time status updates and error messages

## 🚀 Usage

### Basic Renaming

1. **Open the extension** by clicking the icon or pressing `Ctrl+Shift+R`
2. **Enter your title** using the format: `GroupName-TabName`
3. **Click "Rename Tab"** or press `Enter`

### Naming Pattern

```
GroupName-TabName
```

**Examples:**

- `Work-Dashboard` → Group: "Work", Tab: "Dashboard"
- `GitHub-Issues` → Group: "GitHub", Tab: "Issues"
- `Research-AI-Papers` → Group: "Research", Tab: "AI-Papers"

### Grouping Behavior

- **Same Group Name**: Tabs with the same group name are automatically grouped together
- **Unique Colors**: Each group gets a unique color (blue, red, green, etc.)
- **Individual Tab Colors**: Each tab within a group gets a unique outline color
- **Visual Distinction**: Easy to identify tabs at a glance

## ⌨️ Keyboard Shortcuts

| Shortcut                         | Action                 |
| -------------------------------- | ---------------------- |
| `Ctrl+Shift+R` (Windows/Linux) | Open Tab Renamer popup |
| `Cmd+Shift+R` (Mac)            | Open Tab Renamer popup |
| `Enter` (in popup)             | Rename current tab     |

## 📖 Examples

### Example 1: Work Organization

```
Work-Email       → Group: Work (Blue), Tab: Email (Red outline)
Work-Calendar    → Group: Work (Blue), Tab: Calendar (Green outline)
Work-Documents   → Group: Work (Blue), Tab: Documents (Purple outline)
```

### Example 2: Development Projects

```
ProjectA-Frontend → Group: ProjectA (Red), Tab: Frontend (Yellow outline)
ProjectA-Backend  → Group: ProjectA (Red), Tab: Backend (Pink outline)
ProjectB-API      → Group: ProjectB (Green), Tab: API (Orange outline)
```

### Example 3: Research

```
Research-Papers   → Group: Research (Purple), Tab: Papers (Cyan outline)
Research-Notes    → Group: Research (Purple), Tab: Notes (Gold outline)
Research-Tools    → Group: Research (Purple), Tab: Tools (Lime outline)
```

## 🔄 Persistence Rules

### ✅ Names Persist When:

- Reloading the current page
- Navigating within the same domain (e.g., `github.com` → `github.com/issues`)
- Switching between different pages on the same website

### ❌ Names Reset When:

- Navigating to a different domain (e.g., `github.com` → `google.com`)
- Manually restoring tabs using the extension

### Domain Examples

```
✅ github.com → github.com/user/repo (Same domain, name persists)
✅ docs.google.com → docs.google.com/document/123 (Same domain, name persists)
❌ github.com → stackoverflow.com (Different domain, name resets)
❌ youtube.com → gmail.com (Different domain, name resets)
```