RadarBug guide
RadarBug User Documentation
RadarBug is a weather and storm awareness app built to help you monitor radar, lightning, hurricane activity, NWS alerts, and nearby conditions from a single map.
App only: Weather alerts and alert notifications are available only in the RadarBug app.
Dedicated tablet setup
Configure a tablet to stay awake, reduce nighttime brightness, minimize navigation controls, and show the RadarBug forecast.
What the app includes
- Live radar overlay for recent precipitation patterns
- Radar-derived rainfall monitor with recent 1-, 3-, and 6-hour totals
- NWS alerts and warnings for severe weather areas
- Hurricane and storm tracking layers
- Hurricane outlook and disturbance polygons
- Lightning strike activity and configurable local alert radius
- Traffic overlay support
- User-location aware alert checks for nearby storm zones
- Saved home location for anchoring the map view and lightning alerts to a fixed place
- Map style options: Street, Satellite, Terrain, and Hybrid
- Pollen mode (website): Google pollen heatmap and forecast (temporarily paused), AAAAI pollen and mold counts, EPA air quality, temperature and humidity, and NWS fronts
- Backup Mode: Standalone map support for devices without Google Play Services
- Visit Website: Quick access to official website directly from the map
Getting started
- Open RadarBug on your Android device.
- Allow location permission so the app can center on your location and detect nearby storm activity.
- If prompted, allow notifications so storm alerts can be delivered while the app is active or running in the background.
- On the main map, use the settings button in the top-right corner to customize layers and map display.
Main map
The main screen shows a weather map with layer controls and status indicators.
Map controls
- Settings: opens the layer and map configuration screen
- Visit Website: opens www.radarbug.app in your web browser
- Re-center: recenters the map on your location with a broad neighborhood view
- Home: jumps the map to your saved home location; press and hold to save the current view as home
- Mute alerts: temporarily disables lightning alert notifications
Status indicators
The app displays counts for:
- NHC storms
- NWS alerts
- Nearby lightning strikes within the configured radius
Home location
Set a home location to keep the map and your alerts anchored to a fixed place — useful when you want to watch conditions over your house rather than wherever your device happens to be.
Setting home
- Pan and zoom the map to the spot you want, then press and hold the home button to save it. A house marker is dropped and the button turns highlighted.
- The first tap on the home button, when no home is saved yet, also saves the current view.
- To move an existing home, drag the house marker to a new spot, or press and hold the button again from a new view.
Using home
- Tap the home button to jump the map back to your saved home view.
- Your home is remembered between visits, along with your last map position and zoom.
- When a home is set, lightning proximity alerts are measured from home instead of your device location. If no home is set, they fall back to your current location.
Settings
The settings screen includes:
Base Map
Choose from Street, Satellite, Terrain, or Hybrid.
Layers
Toggle Lightning Strikes, Lightning Alerts, Radar, Storm Tracking, Hurricane Outlook, NWS Alerts & Warnings, and Traffic on or off. See NWS Watches vs. Warnings Explained for what the alert layer's wording actually means, and Hurricane Categories & Forecast Cones Explained for how to read the storm tracking layer's cone and category labels.
Radar Controls
Use Radar Opacity to adjust how strongly the radar appears over the base map. Use the Radar Look Back slider to choose how much recent radar history is included in the animation, from Latest Only to 30 minutes in 5-minute steps. RadarBug remembers both settings between visits. New to radar imagery? See How to Read a Weather Radar for what the colors and loop animation actually mean.
Rainfall Monitor
The forecast panel shows a radar-derived rainfall estimate (NOAA's MRMS product, via Iowa Environmental Mesonet) for the last 1, 3, and 24 hours at your exact location. This replaced relying on the nearest NWS station's own rain gauge, since many stations — including some major airports — simply don't report a precipitation total even while it's actively raining there. A dash means the estimate isn't currently available.
Lightning Alerts
When lightning alerts are enabled, you can configure the alert radius in miles and aggregation time in minutes. Use the radius setting to receive alerts only when strikes occur within a chosen distance of your reference point — your saved home location if you have set one, otherwise your current location. The first nearby strike raises an immediate alert; further strikes inside the radius are rolled up into a “storm update” digest at the aggregation interval until a quiet window passes.
On the web, enabling lightning alerts asks for browser notification and location permission. If notifications are blocked, alerts still appear as an on-screen message while the app is open.
See Lightning Safety Explained for the 30-30 rule, why there's no truly safe spot outdoors, and what to do if someone is struck. RadarBug's alerts are a proximity notification, not a substitute for official safety guidance. For that, the gold standard comes from government meteorology and public health agencies: NOAA's National Weather Service, the primary authority on lightning science, real-time storm tracking, and outdoor safety protocols, and originator of the “When Thunder Roars, Go Indoors!” standard; the CDC, for indoor safety and medical first-aid steps if someone is struck; and the National Lightning Safety Council, an independent group of lightning safety experts and meteorologists with detailed statistics and outdoor recreation guidelines.
Mute
Use the Mute Lightning Alerts option to suppress notifications while keeping the map available.
Alert behavior
RadarBug checks whether your current location falls inside a tracked storm, hurricane, or NWS alert polygon. When an alert is active and not muted, the app may display an in-app message, raise a system notification, or show nearby lightning information on the map.
Alert map colors
Every watch, warning, and advisory drawn on the map is colored by the first matching rule below, checked in order — a rule further down never overrides a match above it.
- Warning — always red. Any product with “Warning” in its name (Tornado Warning, Severe T-Storm Warning, Flash Flood Warning, Hurricane Warning, Gale Warning) is red, regardless of category. Checked before every rule below.
- Heat. Excessive Heat / Heat products are drawn as an outline only, colored by severity: purple (extreme), light red (severe), orange (moderate), yellow (minor), blue (unspecified).
- Marine. Small Craft, Gale, Marine, Hazardous Seas, Brisk Wind, Hurricane Force Wind, and Heavy Freezing Spray use plum for watches and medium slate blue for advisories — kept off the red/blue ramp so they still read over open water.
- Tropical cyclone. Hurricane, Tropical Storm, Tropical Cyclone, and Storm Surge products use a warm ramp: orange for watches, amber for statements.
- Flood. Flood and Coastal Flood products use blue for watches and light green for advisories/statements. (Flash Flood Warning is caught by the Warning rule above, not here.)
- Everything else. Tornado, Severe Thunderstorm, Winter Storm, Blizzard, Wind, Fire, and any other watch or advisory not covered above default to blue for a Watch. An Advisory-level product in this catch-all group (Winter Weather Advisory, Wind Advisory, and similar) is drawn as a green polygon instead. Red is reserved for a severe/extreme non-watch product, which is rare since most high-severity products already qualify as a Warning.
Pollen mode (website)
The PollenBug button (the yellow bee) under the rain-totals button switches the map from radar to pollen. Pollen mode turns on the pollen heatmap, pollen count stations, EPA air quality, the temperature and humidity badge, and NWS fronts, and turns off radar and 24-hour precipitation. Tap the button again (it shows the RadarBug icon in pollen mode) to switch back; that turns radar on and those five layers off. Each layer can also be turned on or off on its own in settings.
New to pollen? See Pollen Types, Seasons & Counts Explained for when tree, grass, and weed pollen and mold peak, how to read station counts and the 0–5 forecast index, and how weather affects pollen.
Pollen heatmap and forecast
Temporarily paused: the Google pollen heatmap and tap-for-forecast are switched off on the map while RadarBug waits on AdSense approval. Pollen count stations, air quality, fronts, and the temperature and humidity badge still work.
The heatmap shows Google's pollen index for tree, grass, or weed pollen. Choose the type and opacity in settings. The scale on the left runs from 0 (none) to 5 (very high).
With the heatmap on, tap anywhere on the map to see today's forecast for that spot: each pollen type's category and index, whether it is in season, and Google's health tips.
The heatmap and forecast are model estimates, not measurements.
Pollen count stations
Purple dots show AAAAI National Allergy Bureau counting stations. Tap one to see its most recent sample:
- A pie chart of tree, grass, and weed pollen, with each total and a Low, Moderate, High, or Very High rating
- Mold spores listed separately, because spore counts run far higher than pollen
- Tap a slice or row to see the individual plants or molds counted
Counts are measured by people at each station, so the newest sample may be a few days old. The sample date is shown at the top. Many stations report only during pollen season.
Air quality
EPA AirNow outlines show the latest hourly air quality. Orange marks Moderate; red marks Unhealthy for Sensitive Groups or worse. Areas with Good air quality are not outlined. Tap inside an outline for details, and use the air quality opacity setting to make the outlines stronger or fainter.
Temperature and humidity
A badge on the map shows the current temperature (°F) and relative humidity, refreshed every hour. It sits at your saved home location, or at your current location if you have no home.
Weather fronts
Turn on NWS fronts to see the National Weather Service surface analysis, updated about every 30 minutes.
A front is the boundary between two air masses with different temperature and humidity, such as cool, dry air from Canada meeting warm, humid air from the Gulf of Mexico. Air doesn't mix easily across that line, so the warmer air is pushed upward, where it cools and forms clouds and rain. That is why weather tends to change as a front passes: the wind shifts, the temperature and humidity change, and there is often a band of clouds, rain or storms along it. Fronts usually trail out from a low-pressure center.
The color says which air is moving in. Blue means colder air is advancing and red means warmer air is advancing. The triangles and half-circles sit on the side of the line the front is moving toward, so they point at the places about to get the new air.
- Cold front (blue line with blue triangles): colder air pushing in and lifting the warm air ahead of it sharply. Expect a narrow line of showers or thunderstorms, sometimes severe, with gusty wind. Behind it the temperature drops, the air dries out, the wind turns to the northwest and the sky usually clears.
- Warm front (red line with red half-circles): warmer air sliding up and over the cooler air ahead of it. It moves more slowly, with thickening clouds and long periods of light to steady rain or drizzle, sometimes fog, often a day ahead of the line. Behind it the air is warmer and more humid, with a south wind.
- Stationary front (alternating blue and red, triangles on one side and half-circles on the other): neither air mass is winning, so the front barely moves. Cloudy, wet weather can sit over the same area for days, and repeated storms along it can cause flooding.
- Occluded front (purple line with triangles and half-circles on the same side): a faster cold front has caught up with a warm front and lifted the warm air off the ground. It usually forms near a mature low and brings a mix of both kinds of weather: clouds, rain and a wind shift.
- Trough (dashed brown line): a stretched-out area of lower pressure without a clear temperature contrast. It can still set off clouds, showers and storms, and a wind shift.
- H (blue) and L (red): high and low pressure centers. Highs bring sinking air, light wind and mostly fair weather. Lows bring rising air, stronger wind, clouds and rain, and that is where the fronts meet.
See Weather Fronts Explained for drawings of each symbol, a side-by-side comparison of cold and warm fronts, and how fronts move across the U.S. through the year.
Data sources
RadarBug combines live data from several services, including NOAA/NWS weather alerts, National Hurricane Center storm monitoring, Mesonet radar imagery, and lightning feed data for nearby strikes. The pollen layers use the Google Pollen API, AAAAI National Allergy Bureau pollen counts, EPA AirNow air quality, Open-Meteo temperature and humidity, and the NOAA/NWS Weather Prediction Center surface analysis.
Best practices
- Keep location services on for the most accurate alert detection.
- Enable notification permissions for timed alerts while you are away from the map.
- Use a smaller alert radius when you want a narrower local alert zone.
- Turn off layers you do not need to reduce visual clutter.
- The app remembers your last map position and zoom level, so you can set your preferred broad or tight view for the next time you open it.
- Set a home location for a place you monitor often — one tap returns the map there, and lightning alerts are then measured from that fixed point.
Troubleshooting
- If you do not see your location, verify that location permission is allowed.
- If alerts are not appearing, make sure notifications are enabled and the alert layer is turned on.
- If the map looks blank, check that radar or other overlays are enabled in settings.
- If a pollen station shows no counts, it may be out of season or may not have reported in the last 45 days.
- If a layer does not appear, check that it is turned on in settings and that its opacity is not set too low.
- If data loads slowly, return to the map after a short delay and allow the app to refresh.
Support and usage notes
This app is intended to help users monitor weather risk and storm movement. It should be used as a situational awareness tool, not a substitute for official emergency alerts, local weather forecasts, or emergency guidance.
Always follow local warnings and emergency instructions issued by authorities. See the Privacy Policy for details.
See Terms & Disclaimer for the app's usage disclaimer, or Contact for questions or feedback.