Clipboard History Panel

WHAT IT DOES

Clipboard History Panel captures and stores every piece of text you copy to your clipboard, creating a searchable history that you can access at any time. The extension monitors copy events using both the modern Clipboard API (`navigator.clipboard.readText()`) and legacy methods (`document.execCommand('copy')`), ensuring broad compatibility across browsers. Each copied item is stored with a timestamp and the source page where it was copied. The history panel displays items with previews, timestamps, and source information. You can re-copy any item from history with a single click, delete individual items, or clear the entire history. A search filter lets you quickly find previously copied text. The history persists across browser sessions using GM_setValue, so your clipboard history is always available.

WHERE IT RUNS

The extension works on every website where you can copy text, including complex single-page applications, traditional websites, and any page with text selection. It runs locally in your browser, capturing clipboard events and storing history without sending any data to external servers. The extension supports all major browsers and adapts to both desktop and mobile viewports seamlessly.

HOW TO USE

After installation, the extension automatically captures text you copy. A "📋" badge appears in the bottom-right corner of the page—click it to open the Clipboard History panel. The panel shows all captured items with their preview, source, and timestamp. To re-copy any item, click the item or the copy (📋) button next to it. To delete an individual item, click the delete (×) button. Use the search box to filter items by text content. Click "Clear All" to remove all history. To customize the experience, open the extension panel and choose the maximum number of items to store (25, 50, 100, or 200). Toggle "Auto-capture clipboard" to enable or disable automatic capture. Toggle "Show notification on capture" to show a brief notification when text is copied. Toggle "Clear history on restart" to automatically clear history when the browser restarts. For per-site customization, enable or disable the extension on specific websites using the per-site controls.

THE ACTUAL MECHANISM — CLIPBOARD MONITORING WITH EVENT INTERCEPTION AND STORAGE

The extension uses a multi-layered clipboard monitoring strategy. First, it listens for the `copy` event on the document, which fires when the user initiates a copy operation. After a brief delay (100ms), it reads the current selection using `window.getSelection().toString()` to capture the copied text. Second, it overrides `document.execCommand('copy')` to intercept programmatic copy operations. Third, it attempts to use the Clipboard API (`navigator.clipboard.readText()`) for browsers that support it. When a new item is captured, it is added to the beginning of the history array, and duplicates are removed. The history is persisted using `GM_setValue` with the key 'clipboard_history'. Each entry stores the text, timestamp (Date.now()), and source (document.title or URL). The maximum number of stored items is enforced when adding new items. The panel renders the history with search filtering, and click handlers for re-copy (using `GM_setClipboard`) and delete operations. The panel is positioned as a fixed overlay with z-index 2147483000 to appear above page content.

THE PANEL

The settings panel is a lightweight, draggable overlay that appears in the center of your screen. You can reposition it by clicking and dragging the title bar; release it near the screen edge and it will snap into place automatically. To collapse the panel into a compact title bar, click the minimize button, expanding it again with the same control. The panel is fully responsive, adapting to different screen resolutions with a minimum width of 300px and a maximum of 480px. Press the Escape key at any time to dismiss the panel without applying changes. All controls—the enable/disable toggle, open history button, close button, max items selector, auto-capture toggle, notification toggle, clear on restart toggle, clear all button, and per-site controls—are accessible within a clean, high-contrast interface that respects your system's color scheme.

PLEASE NOTE

This extension requires the free BotGentz companion extension to be installed and active, which provides the underlying DOM access, clipboard, and storage engine. The extension captures text from the clipboard using the Selection API and Clipboard API, which may not capture all copy operations on all websites. The modern Clipboard API (`navigator.clipboard.readText()`) requires user permission and may not work on all browsers. The extension does not capture images, files, or non-text content. The history is stored locally using GM_setValue and is not encrypted—sensitive data should be cleared manually. No personal data, browsing history, or clipboard content is ever transmitted externally. All settings and history data are saved using the browser's storage API and remain solely on your device. The extension does not inject ads, trackers, or analytics of any kind.