Extension Manager

# Extension Manager A Chrome extension that lets you quickly enable and disable your installed extensions from a single popup window, using keyboard shortcuts and customizable key mappings. --- ## Features - **Keyboard‑driven extension toggle** - Open the popup with a global shortcut (default: `Alt+M`) and toggle extensions using letter keys. - Supports single‑letter and two‑letter keys (`a` … `z`, `aa`, `ab`, … `zz`). - **Key Mapping tab** - View all installed extensions with their icons and current keys. - Edit keys directly (1–2 letters `a–z`). - When assigning a key that is already in use, shows a confirmation dialog and safely reassigns the key. - Independent search bar to quickly find an extension by name. - **View Options tab** - Choose how many cards to show per row (2/3/4 columns). - Configure maximum popup height; the popup grows up to that height and then scrolls vertically. - All view options are persisted between sessions. - **Search and filtering** - Toggle Keys tab: search installed extensions by name. - Key Mapping tab: separate search for the mapping list. - `Ctrl+F` / `Cmd+F` focuses the appropriate search box depending on the active tab. - **Persistent settings** - Key mappings, view options, active tab, and theme (light/dark) are stored and restored automatically. - Reset button to clear all key mappings and re‑generate them in alphabetical order. --- ## Usage ### Toggle Keys tab - Search extensions by name using the search field. - Each card shows: - Assigned key - Icon and name - Enable/Disable button - Press the assigned key to toggle the extension: - 1‑letter keys toggle immediately. - 2‑letter keys: - First key press starts a short key sequence window. - Press the second letter within the timeout to trigger the 2‑letter key. - If no second key is pressed and there is a single‑letter mapping with no longer sequence, that 1‑letter key is triggered. ### Key Mapping tab - Use the search field to filter the mapping list by extension name. - Edit keys inline: - Focus the input, type a new key (`a–z`, length 1–2), press Enter or blur. - Conflicts show a confirmation dialog before reassigning. - Use **Reset all keys** to clear all mappings and regenerate keys alphabetically. ### View Options tab - **Columns per row**: choose 2, 3, or 4. - **Max popup height**: choose 480px or 600px. - Changes are applied immediately and saved. --- ## Keyboard Model ### Auto‑assigned keys When there is no saved mapping, keys are assigned automatically in alphabetical order: - Single letters first: `a`, `b`, …, `z` - Then two‑letter sequences: `aa`, `ab`, `ac`, … Assignments are stable: once a mapping is saved for an extension ID, it is reused on the next load. ### Manual key mapping In the **Key Mapping** tab: - Each extension shows: - Icon and name - Current key label (`Key: a`, `Key: aa`, or `Key: -`) - Editable key input (1–2 letters) - Valid keys: - Only `a–z`, length 1–2. - Invalid input (numbers, symbols, 3+ letters) is rejected with an inline error: - `Key must be 1–2 letters (a–z).` When you type a key that is already used: 1. The extension looks up other extensions using the same key. 2. A confirmation dialog appears, for example: ```txt Key 'a' is already used by other extensions. Replace the key there and assign it to this extension? ``` 3. If you confirm: - The key is removed from the conflicting extension. - The key is assigned to the current extension. - A small inline info message shows: - `Key reassigned from other extension.` 4. If you cancel: - No mappings are changed. - The input reverts to the previous key. --- ## Keyboard Shortcuts - **Open popup**: `Alt+M` (configured via `manifest.json` → `commands`). - **Search** - `Ctrl+F` / `Cmd+F`: - On **Toggle Keys**: focuses the main search field. - On **Key Mapping**: focuses the mapping search field. - **Toggle extensions**: - Press the mapped key while the **Toggle Keys** tab is active and focus is not in a text field. --- ## Project Structure - `manifest.json` – Extension metadata, permissions, keyboard command. - `popup.html` – Popup layout and tab structure. - `popup.css` – Styling and responsive grids for each tab. - `popup.js` – All popup logic: - Loading extensions via `chrome.management` - Rendering Toggle / Mapping / View tabs - Key mapping management and conflict handling - View options and theme persistence - Keyboard shortcut handling (key sequences, Ctrl+F / Cmd+F) --- ## Permissions This extension uses the following permissions: - `management` – Required to read the list of installed extensions and enable/disable them. - `commands` – Required to bind the global shortcut for opening the popup. - `storage` – Required to persist user settings (key mappings, view options, theme, last active tab). The extension does **not** access or modify web page content; it only manages browser extensions through the official Chrome APIs.