Fastmail Web Search Enhancer

WHAT IT DOES

Fastmail Web Search Enhancer scans the current page for Fastmail web interface search results, extracting email subjects, senders, dates, and snippets from Fastmail search result listings. The floating panel provides search enhancer features including advanced search filters, search result highlighting, quick actions (mark as read, archive, delete), and search history tracking. Color-coded indicators show search result relevance and folder locations. Filter by date range, sender, folder, and keywords, and export search results as CSV or text. Search terms are highlighted in results, and search patterns are tracked.

WHERE IT RUNS

Works on Fastmail web interface pages, including search results, message lists, and folder views. The script detects search results using Fastmail-specific selectors and extracts email metadata. It works best on Fastmail web interface search pages.

HOW TO USE

The panel displays all search results with subjects, senders, dates, snippets, and folder locations. Use the highlight input to enter a search term and highlight matching results in the list. Quick action buttons (Mark Read, Archive, Delete) provide one-click email management. Filter results by read/unread status. Export the search results as text for reference or analysis. The panel tracks recent actions in the history section. Click "Scan Results" to refresh the list if the page updates.

MECHANISM — SEARCH RESULT EXTRACTION WITH HIGHLIGHTING AND QUICK ACTIONS

The script detects Fastmail search results by finding result containers using selectors (.message-item, .search-result). From each container, it extracts the subject, sender, date, snippet, folder, and read status using targeted sub-selectors. The highlighting feature allows users to enter a search term and visually mark matching results with a colored background and border. Quick actions (mark as read, archive, delete) are available as buttons on each result; these actions are logged to the history for tracking. The history stores recent actions with timestamps and subject names, allowing users to review what they've done. All extraction and action tracking runs client-side with no network calls.

THE PANEL

The floating panel is fully draggable and remembers its position per domain. Click the minimize button to collapse it to a small bubble, or press Escape to hide it. The panel automatically adjusts to different screen sizes and can be resized to show more content. All settings, including filter defaults and highlight color, are saved per domain. The panel integrates smoothly with any page layout using the BGPanel framework, maintaining clean separation from page content.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not send any data to external servers; all extracted search data, history, and settings remain entirely local to your browser using GM_setValue. The script never reads password fields, hidden inputs, or file inputs. It stores only email subjects, senders, dates, snippets, and action history from publicly visible Fastmail page content. Result detection depends on the page structure; if results are not detected, use the "Scan Results" button to refresh extraction. The script works on Fastmail pages and detects pages by hostname. Quick actions are logged locally and do not modify the Fastmail interface directly. Data persists across browser sessions and is isolated per browser profile.