Pollen Count Overlay

WHAT IT DOES

Pollen Count Overlay automatically detects your location from weather content on any webpage and fetches current pollen count data for tree, grass, and weed pollen. The tool displays a compact overlay badge showing the pollen level for each type with color-coded risk indicators — Low (green), Moderate (yellow), High (orange), and Very High (red). This helps allergy sufferers quickly assess the current pollen situation without leaving the page they're browsing, making it easier to plan outdoor activities and manage allergy symptoms.

WHERE IT RUNS

This extension works on any website that contains weather or location-related content. It functions on weather forecast sites, travel pages, outdoor activity guides, news sites with weather sections, and any page with location information. The tool works across all domains and adapts to dynamically loaded content and single-page applications.

HOW TO USE

Install the extension and navigate to any page with weather content. The tool automatically detects the location from the page and fetches pollen data. A compact pollen badge appears in the corner of the page showing tree, grass, and weed pollen levels with risk indicators. Click the badge to refresh the data. Use the overlay panel to customize the experience: toggle individual pollen types (tree, grass, weed) on or off, choose the badge position (top-right, top-left, bottom-right, or bottom-left), switch between auto-detect and manual location entry, adjust the refresh interval in minutes (default 60 minutes), and click "Refresh Pollen" to manually update the data.

TECHNICAL SECTION — LOCATION DETECTION AND POLLEN DATA SIMULATION

The extension uses a multi-strategy location detection engine that scans the page for location-related content, including common location selectors, page titles, and meta tags. Once a location is found, it is geocoded using the geocode.xyz service to obtain latitude and longitude coordinates. Since free public APIs do not provide real pollen data, the tool generates realistic pollen counts based on the UV index (from OpenUV API) and the current season (spring, summer, fall, winter). Tree pollen peaks in spring, grass in summer, and weed in fall, with each type scaled appropriately. The simulated data is cached with a configurable refresh interval to provide consistent information while reducing API calls. A real pollen API would be used in production if a free, reliable source becomes available.

THE PANEL — DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The overlay panel is fully interactive and designed for seamless multitasking. Drag it anywhere on the screen using the handle at the top of the panel; the position is saved per site so it stays where you left it across sessions. The panel includes a snap-to-edge feature that gently anchors the overlay to the nearest screen edge when released. Click the collapse button to minimize the panel to a compact pill showing the current pollen status; expand it again with a single click. Resize the panel vertically by dragging the bottom-right corner to view more controls. Press the Escape key at any time to instantly close the overlay; it reappears on the next page navigation or refresh.

PLEASE NOTE

This extension requires the free BotGentz companion extension to function, as it provides the underlying content script injection and cross-origin communication framework. No personal data, browsing history, or location data is stored, transmitted, or shared. Location detection uses geocode.xyz, a free public service — no personal information is transmitted beyond the location string required for geocoding. UV data is fetched from OpenUV (free tier). Settings are stored locally in your browser using GM_setValue and are never sent to any external server. The extension does not access or store login credentials, financial data, or personally identifiable information. The pollen data is simulated based on seasonal patterns and UV index, as free pollen APIs are not currently available. Users should verify pollen levels with local sources when accuracy is critical. The pollen badge is a helpful reference tool and should not replace professional medical advice.