Storm Alert Banner Injector

WHAT IT DOES

Storm Alert Banner Injector places a highly visible, fixed-position banner at the top of every webpage you visit, displaying active severe weather alerts for your exact geographic location. The banner dynamically fetches real-time alert data from the National Weather Service API and presents it with color-coded severity levels: red for severe/extreme warnings, orange for warnings, blue for watches, and purple for advisories. A live countdown timer shows exactly how much time remains until each alert expires, ensuring you always know when the threat has passed. The banner includes a direct link to the full alert details and can be dismissed temporarily, but will automatically reappear if you reload the page while an alert remains active. The system intelligently prioritizes the highest-severity alert when multiple warnings are active in your area.

WHERE IT RUNS

This script operates as a userscript within the BotGentz extension, running on every webpage you load across all websites. It works seamlessly on any modern browser that supports the BotGentz extension, including Chrome, Firefox, Edge, and Safari. The script runs entirely client-side within the context of each webpage, requiring no server-side infrastructure or external services beyond the public weather API. It integrates with the page's existing content without interfering with functionality, and the banner overlay stays fixed at the top regardless of scrolling.

HOW TO USE

After installation, the script automatically requests your location permission on first run. Once granted, it immediately begins scanning for active weather alerts in your area. No additional configuration is required for basic operation — the banner simply appears when an alert is active. Use the panel to adjust the severity threshold (Advisory, Watch, or Warning), enabling you to filter out lower-priority alerts. The panel also allows you to toggle the entire system on or off, adjust banner opacity from 50% to 100%, manually trigger a new scan, clear all dismissed alerts, or reset all settings to defaults. Click the × button on any banner to dismiss it until the alert expires, or click the "Details" link to open the full alert information in a new tab.

THE MECHANISM THAT MAKES IT WORK

Unlike generic weather widgets that rely on zip code approximations or IP geolocation, this script uses the W3C Geolocation API to obtain precise latitude and longitude coordinates with accuracy up to 10-50 meters. It then queries the National Weather Service's public API endpoint (api.weather.gov/alerts/active) using the point parameter format, which returns all active alerts for that exact coordinate. The script implements a severity weighting system: Extreme (4), Severe (3), Moderate (2), Minor (1), and Unknown (0), and automatically displays only the highest-severity active alert to avoid overwhelming the user with multiple warnings. The countdown timer updates every 60 seconds using JavaScript's setInterval, calculating the exact time remaining by comparing the current system clock against the alert's expires timestamp. Dismissed alerts are stored with their unique IDs in GM_setValue, and the system automatically clears expired alerts from the dismissal list, ensuring you never miss a new warning.

THE PANEL

The panel is built using BotGentz's BGPanel framework and provides a clean, accessible interface for managing the script. It opens as a floating overlay that can be dragged anywhere on the screen by clicking and holding the title bar. The panel includes a toggle switch to enable or disable banner injection, a dropdown menu to select the minimum severity threshold (Advisory, Watch, or Warning), a slider to control banner opacity from 50% to 100%, and a live location display showing your current coordinates. Action buttons let you update your location, manually scan for alerts, clear all dismissed alerts, or reset all settings. The panel automatically collapses to a small icon when not in use and expands when clicked, remaining out of the way while providing full control at your fingertips. Press the Escape key to close the panel at any time.

PLEASE NOTE

This script requires the free BotGentz extension to be installed and activated in your browser. The extension is available from the official BotGentz website. The script relies on the National Weather Service API, which may occasionally change its endpoints, response format, or rate limits. If you experience issues, please check for script updates, which are delivered automatically through the BotGentz extension update system. The script requests your location to provide accurate alerts — no location data is stored, transmitted, or shared with any third-party services beyond the NWS API request. All location processing occurs locally within your browser, and no browsing history, page content, or personal data is collected or transmitted.