Tab Renamer

### 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) ```