History Search Enhancer Overlay

WHAT IT DOES

This script transforms the basic browser history page into a powerful search and analysis tool. It adds real-time filtering as you type, allowing you to instantly narrow down history entries without waiting for page reloads. Advanced regex support lets you perform pattern-based searches that find exactly what you're looking for—even complex URL structures or specific date formats. The date range filter shows only entries from the last N days, helping you focus on recent activity. You can also export your filtered history results to CSV or JSON format, making it easy to analyze browsing patterns, share findings, or create backups.

WHERE IT RUNS

The script works on any page that displays your browser history, including chrome://history, edge://history, and similar pages in other Chromium-based browsers. It also runs on custom history pages used by some browser extensions and internal tools. The script automatically detects history entries regardless of how they're rendered, using intelligent selectors that adapt to different browser implementations.

HOW TO USE

After installation, open your browser's history page and look for the script's panel. Type any search term into the search box to instantly filter history entries in real time. Enable "regex search" to use regular expressions for advanced pattern matching. Toggle the date range filter and set the number of days to include entries from. Adjust the maximum results limit to control how many entries are displayed. Use the "Apply Filter Now" button to refresh the view, or rely on auto-filter to update as you type. Export your filtered results with a single click—CSV format works well for spreadsheets, while JSON is ideal for programmatic use.

TECHNICAL MECHANISM

This script operates without any browser history APIs, which are unavailable in userscript contexts. Instead, it directly parses the DOM of the history page, extracting titles, URLs, timestamps, and other metadata from visible elements. It uses a collection of fallback selectors to locate history items across different browsers and page structures. For date filtering, the script employs natural language parsing to extract timestamps from human-readable date strings, converting them to milliseconds for accurate comparison. Regular expression support is implemented using JavaScript's native RegExp object, with error handling that gracefully falls back to simple string matching when invalid patterns are entered. The export function serializes the currently visible history entries into the chosen format and copies the output to your clipboard using GM_setClipboard.

THE PANEL

The settings panel is fully draggable and can be positioned anywhere on your screen. It automatically snaps to the nearest edge when released, keeping your workspace organized. The panel can be collapsed to a small bubble showing only a gear icon, and restored with a single click. Its position is remembered across page reloads using GM_setValue. The panel also responds to the Escape key, which instantly hides it until you click the bubble again. All settings are saved immediately when changed and persist across browser sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. Browser history pages may change their HTML structure with updates, which could affect the script's ability to detect history entries. If you notice the script is not working after a browser update, check for script updates or contact the developer. The script does not access, store, or transmit your browsing history or any personal data. All processing and filtering happen locally in your browser, and exported data is copied only to your clipboard—it never leaves your device.