Home Products Philosophy Contact View All Products
Weather Belt Documentation

Weather Belt — User Manual

Complete guide to every feature

Version 1.0 Back to Weather Belt

To download as PDF: File → Print → Save as PDF

Getting Started

  • System requirements: iPhone running iOS 16 or later.
  • First launch: the onboarding flow introduces all data sources and requests notification permission.
  • No account required — open the app and data loads automatically using your GPS location.
  • For AI agents: obtain an API key from OpenAI, Anthropic, or Google Gemini and enter it in Settings → AI Provider.
  • For Broadcastify scanner audio: obtain a Broadcastify API key and enter it in Settings → Data Sources.
  • For Lightning: obtain a free Tomorrow.io API key and enter it in Settings → Data Sources.
  • For AirNow air quality: obtain a free EPA AirNow key and enter it in Settings → Data Sources.
  • All keys are stored encrypted on your device and never transmitted to Ghost Logics.

Home Dashboard

The Home tab is your live situational awareness dashboard. Everything updates automatically based on your current GPS location.

Hero Section

  • Displays your current city and region (reverse geocoded from GPS).
  • Live temperature pulled from the nearest METAR aviation weather station.
  • Plain-English condition derived from raw METAR data (Clear, Partly Cloudy, Rain, Thunderstorms, etc.).
  • Barometric pressure from your device's physical sensor — always accurate regardless of network.
  • Background gradient shifts with weather conditions: deep navy for clear, dark red for thunderstorms, slate for rain, blue-white for snow.
  • Tap "Updated Xm ago" to force a manual METAR refresh. Data refreshes automatically every 15 minutes.

Rapid Pressure Drop Badge

  • When your device barometer detects a rapid pressure drop (configurable threshold in Settings → Barometer), an amber "Rapid drop" badge appears next to the pressure reading.
  • A rapid pressure drop is a proven early indicator of approaching severe weather — often visible before NWS issues official watches or warnings.
  • A push notification fires when a rapid drop is detected (requires Background Alerts enabled in Settings).

Risk Card

  • Shows the highest severity active NWS alert within 50 miles of your current location or any saved location.
  • Alert severity is color-coded: HIGH RISK (Extreme), ELEVATED RISK (Severe), MODERATE RISK (Moderate), ACTIVE ALERT (Minor).
  • Shows the alert event name, affected area, and approximate distance.
  • Tap "View Radar" to jump to the Map tab with NEXRAD radar enabled.
  • When no qualifying alerts exist within 50 miles, shows ALL CLEAR with a green shield.
  • Alerts beyond 50 miles do not trigger the risk card — this keeps your home screen relevant to your actual location.

What You Should Do

  • Four context-aware action tiles that change based on the active alert type.
  • Tornado Warning → shelter guidance. Flood Warning → evacuation guidance. Severe Thunderstorm → shelter and surge protection. Winter Storm → supply and travel guidance. Wildfire → evacuation and smoke protection. Hurricane → evacuation and preparation.
  • When no active local alerts exist, shows general preparedness guidance.
  • Tile border color and ambient glow shift with alert severity — green for all clear, amber for moderate, deep orange for severe, crimson for extreme.

Quick Actions

  • Scanner — opens live scanner audio.
  • My Locations — manage your monitored locations.
  • Geofence — configure alert zones.
  • Reference — offline emergency guides and safety references.

Data Trust Strip

  • Last Radar Update — timestamp of the most recent NEXRAD frame loaded.
  • Active Alerts — count of NWS alerts currently active. Tap to navigate to the Alerts tab.
  • Data Source — shows Online or Offline based on current network status.

Intelligence Layer

Weather Belt monitors multiple data sources simultaneously and surfaces proactive intelligence cards on the Home tab when conditions warrant. All cards are dismissible and re-evaluate automatically.

Incident Intelligence Banner

  • Triggers when 2 or more of the following are active simultaneously within 50 miles: active NWS alert, nearest METAR station reporting IFR or LIFR flight conditions, NASA wildfire hotspot.
  • Amber banner shows which signals are active and approximate distance.
  • Tap to dismiss — re-evaluates after 30 minutes if conditions persist.

Flood Risk Intelligence Banner

  • Triggers when your device GPS elevation is below 100 feet above sea level AND an active Flood Warning or Flash Flood Warning exists within 50 miles.
  • Elevation data from Open-Meteo (free, no key required). Cached for 24 hours.
  • Blue banner with evacuation guidance.
  • Tap to dismiss — re-evaluates after 30 minutes.

Storm Approach Timeline Banner

  • Triggers when an active Severe Thunderstorm Warning or Tornado Warning exists within 200 miles and the NWS warning includes storm motion data.
  • Calculates estimated arrival time at your location based on storm direction, speed, and bearing.
  • Only shows when estimated arrival is within 3 hours.
  • Amber banner shows: direction storm is coming from, speed in mph, estimated arrival countdown.
  • Countdown ticks down in real time between 5-minute data refreshes.
  • Tap to dismiss — re-evaluates after 15 minutes (shorter cooldown given time-critical nature).
  • Does not show if storm motion data is absent from the NWS warning — no guessing.

7-Day Forecast

  • Horizontally scrolling card row below the What You Should Do section.
  • Data from NWS Gridpoints API — free, no key required, official government forecast.
  • Each card shows: day name, weather emoji, high/low temperature, short forecast description.
  • Refreshes every 30 minutes. Cached for offline use after first load.
  • If forecast is unavailable (no network, NWS outage), shows a graceful offline message.

Map Dashboard

  • The Map tab is your primary intelligence interface.
  • Full-screen interactive map using OpenStreetMap base tiles.
  • Top bar shows active alert pill (red = active warning in your area) and Settings gear.
  • Tap the LAYERS button in the bottom left to open the layer toggle panel.
  • The LAYERS button pulses on first launch to draw your attention to it.
  • Tap any map marker to open a detail card at the bottom of the screen.
  • Radar scrubber appears at the bottom when NEXRAD is enabled — drag to scrub through time or tap Play for animation.
  • Storm motion vectors appear over active Severe Thunderstorm and Tornado Warnings when NEXRAD is enabled and storm motion data is available.

Map Layers

Toggle any layer on or off from the LAYERS panel. Layers can be combined.

Weather Alerts (WX)

  • Data source: NOAA/NWS — updates continuously.
  • NWS weather alerts cover the United States and US territories only.
  • Displays colored polygons on the map for each active alert zone.
  • Severity colors: Red = Warning, Orange = Watch, Yellow = Advisory.
  • Tap any polygon to see event type, affected area, and expiration time.
  • AI Weather Interpreter agent translates alert jargon into plain English.

Seismic (SES)

  • Data source: USGS Earthquake Hazards Program.
  • Real-time earthquake data worldwide.
  • Pin size scales with magnitude.
  • Minimum magnitude filter configurable in Settings → Map Preferences.
  • Tap any pin to see magnitude, location, depth, and time.

Aviation / METAR (AVN)

  • Data source: FAA/NOAA METAR reports.
  • Color-coded flight categories: VFR (green), MVFR (blue), IFR (red), LIFR (magenta).
  • Wind direction arrows rotate to show actual wind direction at each station. Calm winds show a dot.
  • Tap any station to see decoded conditions: visibility, ceiling, weather phenomena, wind speed, temperature.
  • AI Aviation Briefer translates raw METAR data into plain English flight conditions.

Marine (MAR)

  • Data source: NDBC (National Data Buoy Center).
  • Real-time buoy readings: wind speed and direction, wave height, water temperature, pressure.
  • Tap any buoy for full observation data.
  • AI Marine Briefer provides plain English coastal and waterway conditions.

Wildfire (FIRE)

  • Data source: NASA FIRMS (Fire Information for Resource Management System).
  • VIIRS satellite hotspot data.
  • Data range configurable in Settings → Map Preferences (1, 3, or 7 days).
  • Enter your NASA FIRMS API key in Settings → Data Sources to use your own access.
  • Tap any hotspot to see confidence level and detection time.

Lightning (LTG)

  • Data source: Tomorrow.io (BYOK required).
  • Requires a free Tomorrow.io API key in Settings → Data Sources.
  • Shows lightning proximity and strike count data for your area.
  • Updates every 5 minutes. Free tier: 25 calls/hour — rate limit handled automatically.
  • When no key is configured, the map shows "No Tomorrow.io key configured."
  • Tap the Lightning row in the Alerts tab to jump directly to the map with this layer enabled.

NEXRAD Radar

  • Data source: RainViewer.
  • Animated composite precipitation radar.
  • 8-frame animation loop — scrub manually or tap Play for auto-animation.
  • Frame stagger loading prevents rate limit errors.
  • Storm motion vectors overlay automatically when active severe warnings include motion data.
  • Updates every few minutes with latest available frames.

Storm Outlook (SPC)

  • Data source: NOAA Storm Prediction Center.
  • Displays categorical convective outlook for today and tomorrow.
  • Color zones from Thunderstorm risk through Moderate and High risk.
  • Use alongside NEXRAD to understand the broader severe weather setup for the day.

HAM Radio

  • Data source: Bundled FCC repeater data.
  • Displays ham radio repeater pins on the map.
  • Tap any pin: output/input frequency pair, PL/CTCSS tone, mode (FM, DMR, P25, Yaesu Fusion, D-STAR), callsign, coverage area, operational status, and network affiliation (RACES, ARES, Skywarn, etc.).
  • Ham radio repeaters are critical emergency communication infrastructure when cellular networks fail.
  • A valid FCC amateur radio license is required to transmit. Weather Belt provides monitoring and reference data only.

GMRS

  • Data source: Bundled FCC GMRS license data.
  • Displays GMRS repeater pins on the map.
  • Tap any pin: frequency, PL/CTCSS tone, callsign, location, and open/closed status.
  • GMRS is widely used for neighborhood and family emergency communication networks.
  • GMRS requires an FCC license (no exam required — available at fcc.gov). Weather Belt provides monitoring and reference data only.

Shelters

  • Data source: FEMA evacuation shelter data.
  • Shows open emergency shelters in your area during active events.
  • Tap any shelter for name, address, and capacity information.

Hurricanes

  • Data source: National Hurricane Center.
  • Displays active tropical cyclone tracks, projected cone of uncertainty, and current position.
  • Use alongside Weather Alerts and NEXRAD for coastal storm situational awareness.

Alerts Tab

Your centralized alert intelligence view.

Active NWS Alerts (WX Feed)

  • Live scrolling list of active NWS alerts sorted by severity (Extreme first).
  • Each row shows: event name, severity badge, affected counties/areas, expiration time.
  • Count badge on the Alerts tab icon shows local alerts within 50 miles.
  • Tap the Active Alerts count on the Home tab to jump here directly.

NEXRAD

  • Tap "View Live Radar" to jump to the Map tab with radar enabled.

Hazards

  • Severe — severe weather safety reference guide.
  • Seismic — earthquake preparedness reference (NIMS).
  • Fire — geofence alert zone configuration.
  • Lightning — tap "MAP" to jump to the Map tab with lightning layer enabled.

Preparedness References

  • Emergency Contacts, NWS Glossary, Getting Started setup guide.

Scanner

Access via Quick Actions on Home tab or More tab.

Free Tier: OpenMHz — No Key Required

  • Browse scanner systems by state.
  • View latest calls with talkgroup names and timestamps.
  • Tap Play to listen to any recorded call.
  • Auto-play toggle for newest calls.

Premium Tier: Broadcastify (BYOK)

  • Enter your Broadcastify API key in Settings → Data Sources.
  • Search channels by location, agency, or frequency.
  • Live streaming audio.
  • Recently played channels saved automatically.

AI Decode

  • Scanner Decoder agent translates transmissions into plain English.
  • Decodes 10-codes, NIMS terminology, and dispatch chatter into readable incident summaries inline.

AI Agents

Six specialized agents available in the Agents tab.

  • Weather Interpreter — translates NWS alert jargon and METAR conditions into actionable plain English summaries.
  • Scanner Decoder — decodes scanner transcripts, 10-codes, dispatch chatter into ICS-style incident timelines.
  • Incident Analyst — cross-correlates weather alerts, seismic activity, scanner traffic, and shelter status into unified situational picture.
  • Evacuation Advisor — provides structured go/stay guidance, routes, and checklists based on active alerts and your location.
  • Marine Briefer — interprets NDBC buoy observations and NOAA marine forecasts into plain mariner briefings.
  • Aviation Briefer — decodes METAR, TAF, SIGMET, and PIREP data into structured flight condition language.

Requires an API key from OpenAI (GPT-4o), Anthropic (Claude), or Google (Gemini). Enter key in Settings → AI Provider. Your key is stored encrypted on your device — never transmitted to Ghost Logics. All agent responses carry an AI-generated disclaimer — always verify with official sources.

Geofence Alert Zones

  • Create custom alert zones for locations you want to monitor.
  • Access via Quick Actions on Home tab or More tab.
  • Tap + to create a new zone. Set: zone name, location, radius (50–500 miles), alert types.
  • Alert types: Tornado Warning, Severe Thunderstorm, Flash Flood, Earthquake 4.0+, Hurricane, Winter Storm.
  • Toggle zones on/off without deleting them.
  • Background monitoring fires push notifications when a qualifying event enters your zone.
  • Requires Background Alerts enabled in Settings → Notifications.

My Locations

  • Save up to 5 locations to monitor conditions anywhere.
  • Access via Quick Actions on Home tab or More tab.
  • GPS location is always available and cannot be removed.
  • Tap any saved location to make it active — all feeds, risk card, and alerts update to that location.
  • Add locations by city name, state, or zip code.
  • Proximity-based features (risk card, alert filtering, intelligence banners) check all saved locations simultaneously.

Off-Grid Mode

Access via More tab.

  • Explains Apple satellite capabilities available on supported iPhone models (Emergency SOS via Satellite, Messages via Satellite, Roadside Assistance).
  • Readiness checklist: charge all devices, screenshot latest radar and alerts, share your location with contacts, find open sky for satellite signal.
  • Emergency message template with fill-in fields for quick communication when data is unavailable.
  • Weather Belt does not control Apple satellite features — this screen provides readiness guidance and preparation context.

Reference Library

Fully offline emergency reference guides. No internet required once installed.

  • Police/Fire 10-Codes — common radio codes used by emergency services.
  • NATO Phonetic Alphabet — standard communication alphabet.
  • Beaufort Wind Scale — wind speed to condition translation.
  • NIMS/ICS Structure — National Incident Management System overview.
  • METAR Decoder Guide — how to read raw aviation weather reports.
  • NWS Alert Glossary — what every NWS alert type means.
  • Severe Weather Safety — shelter guidance for tornado, flood, lightning, and winter weather.
  • Emergency Contacts — critical emergency service reference numbers.

Compass

A full-screen magnetic heading instrument for field orientation when you need cardinal direction without leaving Weather Belt.

What it does

  • Shows live magnetic heading (degrees and cardinal labels) using the iPhone magnetometer, with smoothing so readings stay readable while you move.
  • Night mode activates automatically based on real sunrise and sunset times for your GPS location. The display switches to a deep navy background with cyan glow accents so you can read your bearing in low light without wrecking your night vision. No manual toggle — it just works.

How to use it

  • Open the Tool Belt → Compass. Hold the phone flat (parallel to the ground) like a traditional compass for the steadiest needle.
  • If heading drifts, move the device in a gentle figure-eight to help iOS re-calibrate the magnetometer, then return to a flat pose.
  • Night mode engages automatically at sunset and disables at sunrise based on your current coordinates.

Data sources

  • Uses on-device magnetometer and motion coprocessor only—no network required. Magnetic north can differ from true north; for critical navigation pair with map bearing and local declination guidance.

Thermal Calculator

Computes apparent temperature for hot-humid conditions (heat index) and cold-windy conditions (wind chill) from the values you enter—ideal for spot checks when you are away from a forecast card.

What it does

  • Heat index blends air temperature and relative humidity to describe how hot it feels in shade, light wind conditions.
  • Wind chill describes heat loss on exposed skin for cold air combined with wind.
  • Outside the valid ranges for those formulas, the tool shows the actual air temperature so you are never shown a misleading "feels like" number.

How to use it

  • Open Tool Belt → Thermal Calculator, enter the current dry-bulb temperature and either relative humidity (for heat index) or sustained wind speed (for wind chill), then read the computed value and any range notice.
  • Use heat index during heat advisories; use wind chill during winter wind events. Always cross-check with NWS watches and warnings on the Home and Alerts tabs.

Formulas & validity (NWS-aligned)

  • Heat index uses the NWS Rothfusz regression (intended for temperatures ≥80°F). When relative humidity is below 40%, the tool uses the Steadman heat-index formulation for that low-humidity regime instead of extrapolating Rothfusz outside its comfort region.
  • Wind chill uses the NWS 2001 wind chill formula, which is valid for air temperatures below 50°F with wind speeds greater than 3 mph.
  • Outside those ranges (for example, mild temperatures without meaningful wind chill, or heat-index inputs below Rothfusz thresholds), the interface shows the actual measured air temperature rather than forcing a heat-index or wind-chill value.

Data sources

  • Pure on-device math—no API calls. Values you type might come from your own Kestrel, vehicle thermometer, METAR via Weather Belt, or any other trusted sensor.

Lightning Distance

Classic flash-to-bang estimator: start a timer at the lightning flash, stop it at thunder, and convert elapsed seconds to approximate range using the speed of sound.

What it does

  • Measures the gap between visible lightning and audible thunder, then reports approximate distance in miles and kilometers.
  • Reinforces the rule of thumb that each five seconds is roughly one mile (or three seconds per kilometer) at sea-level conditions.

How to use it

  • Tap Start when you see the flash, tap Stop when you hear thunder (or use the on-screen controls equivalent to start/stop).
  • Repeat for several strokes to average out reaction time. If thunder overlaps the next flash, reset and capture a cleaner pair.
  • When distance is inside ~6 miles, treat the storm as overhead and move to safe shelter immediately—do not rely on the timer alone.

Data sources

  • No external data feed—physics only. This is distinct from the Map layer lightning (Tomorrow.io) which plots detected strikes.

My Coordinates

Shows your current latitude and longitude with one-tap copy and share actions so you can paste into messaging apps, SAR forms, or dispatch traffic.

What it does

  • Displays decimal degrees (and supporting formats where shown in-app) derived from iOS Core Location.
  • Provides share sheet and clipboard actions for rapid distribution to teammates or family.

How to use it

  • Grant Location permission when prompted. Open Tool Belt → My Coordinates and wait for the accuracy ring to settle.
  • Use Copy for pasting into SMS, APRS messages, or email; use Share for AirDrop or radio-linked apps.
  • For best accuracy, stand clear of vehicles and metal roofs; refresh if you have moved significantly.

Data sources

  • GPS, Wi-Fi, and cellular fixes as provided by iOS. Coordinates are computed on-device; Weather Belt does not upload your position to Ghost Logics servers (see Privacy & Data).

River Gauges

Pulls USGS National Water Information System (NWIS) instantaneous values for river stage and streamflow near you or at bookmarked sites so you can correlate flooding alerts with live water levels.

What it does

  • Lists nearby USGS gauges with current stage (feet) and discharge (cfs) where published.
  • Highlights rapid rises when consecutive observations increase beyond a configurable threshold so you can spot flash-rise signatures.

How to use it

  • Open Tool Belt → River Gauges. Allow location to sort gauges by proximity, or search by USGS site number if you already know the gauge ID from AHPS or USGS WaterAlert.
  • Tap a site for recent readings and metadata (drainage name, datum). Cross-reference NWS Flood Warnings on the map and Alerts tab.

Data sources

  • United States Geological Survey (USGS) Water Data services—public, authoritative hydrology. Requires internet; USGS may briefly delay telemetry during maintenance.

Shelter in Place

Structured FEMA-aligned guidance for hazardous atmosphere or civil emergency scenarios where evacuation is not immediately possible or contraindicated.

What it does

  • Walks you through shelter-in-place basics: sealable room selection, HVAC/dehumidifier shutdown, communication check-ins, and pet considerations.
  • Emphasizes official information sources (Wireless Emergency Alerts, NOAA Weather Radio, local OEM) rather than rumor networks.

How to use it

  • Open Tool Belt → Shelter in Place when authorities instruct you to stay indoors (hazmat release, severe smoke, some law-enforcement events).
  • Follow the checklist top-to-bottom; tick items as you complete them if the UI provides checklist affordances.
  • If conditions worsen or evacuation is ordered, switch to Evacuation Advisor and official evacuation routes.

Data sources

  • Curated from FEMA shelter-in-place protocols and related public-domain emergency guidance bundled inside the app—available offline once installed.

Evacuation Advisor (field tool)

A rules-based field assistant that suggests cardinal evacuation bias, timing reminders, and checklist prompts using active hazards near your GPS fix. This complements the AI Evacuation Advisor agent in the Agents tab, which can reason in natural language when you supply a BYOK key.

What it does

  • Correlates NWS polygons (tornado, severe thunderstorm, hurricane, wildfire smoke layers when enabled) with your position to recommend a preferred initial heading away from the hazard core.
  • Surfaces practical reminders: fuel, medications, documents, alternate routes if primary roads are under water.

How to use it

  • Open Tool Belt → Evacuation Advisor during a warning. Read the suggested direction as a starting heuristic, not a guaranteed safe corridor—always obey law enforcement roadblocks.
  • Cross-check with the Map tab (radar, fire, surge layers) before committing to a route.

Data sources

  • Uses the same NOAA/NWS alert geometries and motion vectors already ingested by Weather Belt, plus optional wildfire hotspot context from NASA FIRMS when that layer is enabled.

Go-Bag Checklist

A context-aware packing list that adds or highlights items based on the hazards Weather Belt currently sees around you (for example, cold wave vs hurricane vs wildfire smoke).

What it does

  • Starts from a baseline 72-hour kit (water, food, lighting, comms, first aid).
  • Automatically stresses winter traction aids, N95 masks, pet carriers, or waterproofing when matching alerts are active.

How to use it

  • Open Tool Belt → Go-Bag Checklist before seasonal storm season or when a watch is upgraded to a warning.
  • Check items off as you pack; reset seasonally to avoid stale inventory.

Data sources

  • Logic driven by active NWS headlines in the same proximity window as your Home dashboard risk card, plus optional user toggles for household-specific needs (infants, seniors, pets).

Dead Reckoning

Lets you propagate a position forward from a known fix using heading, speed, and elapsed time—useful when GPS is jammed, indoors, or to sanity-check a track log.

What it does

  • Accepts a starting coordinate (defaults to your last good GPS fix), course in degrees true or magnetic, speed, and time interval.
  • Outputs an estimated new coordinate using flat-Earth approximation suitable for short distances (tactical miles), not transoceanic navigation.

How to use it

  • Capture a known point, then enter the heading you have been steering and average speed for each leg.
  • Update the fix whenever you regain satellite lock to limit cumulative error.

Data sources

  • Pure on-device trigonometry—no network. Initial fixes come from Core Location when you seed the tool.

Triage Templates

Pre-written message skeletons for SAR, family reunification, and mutual aid comms so you can fill in blanks fast under stress.

What it does

  • Provides ICS-flavored formats (WHO/WHAT/WHERE/WHEN) for SMS, Winlink-style radio email, and voice read-back scripts.
  • Inserts your coordinates from My Coordinates when you authorize paste-through.

How to use it

  • Open Tool Belt → Triage Templates, pick a scenario (medical, trapped, utility damage), tap fields to edit, then Copy or Share.
  • Practice templates in non-emergency drills so muscle memory exists.

Data sources

  • Static template library bundled with the app—offline capable. Optional merge fields pull live GPS only when you explicitly allow it.

Visibility Danger

Translates reported visibility (miles or meters) into operational cautions for surface driving, light general aviation, and small-craft marine use.

What it does

  • Maps METAR visibility values (or your own measured visibility) to color-coded risk bands for each mode.
  • Calls out common thresholds (e.g., IFR/LIFR crossover, marine dense fog) with plain-language guidance.

How to use it

  • Enter visibility from the nearest METAR (also shown on the Map tab) or from your own observation.
  • Select mode tabs (Drive / Fly / Marine) to see mode-specific cautions.

Data sources

  • Threshold tables follow FAA flight category breakpoints and WMO marine fog conventions; manual entry can be fed by NOAA METAR via Weather Belt or eyewitness estimates.

Incident Journal

A lightweight, geo-tagged logbook for storm intercepts, damage surveys, or exercise after-action notes tied to time and place.

What it does

  • Creates chronological entries with optional photos, voice-to-text, and automatic GPS stamps.
  • Exports CSV or PDF for insurance, spotter training, or team debriefs (export formats as provided in-app).

How to use it

  • Open Tool Belt → Incident Journal, tap New Entry after significant observations.
  • Keep entries factual (what, where, intensity); avoid speculation that could be misread as official storm reports unless you are submitting through proper NWS channels.

Data sources

  • Stores data locally on device by default. Future "Incident Journal Community Sharing" (see product roadmap on the Weather Belt page) will be opt-in if and when released.

Settings

Data Sources (BYOK Keys)

All keys stored encrypted on device. Eye icon toggles visibility. Green confirmation appears on successful save.

Key What it unlocks Where to get
NASA FIRMS Key Your own wildfire data access firms.modaps.eosdis.nasa.gov
Broadcastify Key Premium scanner live streaming broadcastify.com
RadioReference Key Optional — layers use bundled data without this key radioreference.com
AirNow Key Air Quality Index data airnowapi.org
Tomorrow.io Key Lightning layer (free tier: 25 calls/hour) tomorrow.io

AI Provider

  • Configure OpenAI, Anthropic, or Gemini API key for AI Agents.
  • Navigate to Agents tab after configuring to select your provider.

Map Preferences

  • Wildfire Data Range — 1, 3, or 7 days of NASA hotspot history. (7 days uses 5-day maximum per NASA API limits.)
  • Seismic Minimum Magnitude — filter out earthquakes below 0.0+, 2.5+, or 4.0+.
  • Wind Units — knots or mph for wind display.

Severe Weather Alerts

  • Minimum Severity — filter NWS alerts below Extreme, Severe, Moderate, or Minor threshold.
  • Alert Radius — 50, 100, 200, 500 miles, or National.
  • Per-event toggles — enable/disable specific alert types (Tornado, Severe Thunderstorm, Flash Flood, Hurricane, Winter Storm, Blizzard, Ice Storm, Dust Storm, Extreme Heat, Tsunami).

Barometer

  • Rapid Drop Threshold — 2, 3, or 5 hPa sensitivity for storm precursor detection.
  • Show Station Pressure Label — show or hide pressure reading in hero section.

Notifications

  • Background Alerts — enables geofence and pressure drop notifications.
  • Sound — alert notification sound on/off.
  • Vibration — alert vibration on/off.
  • Critical Alerts — see Critical Alerts section below.

About

  • App version, system status (Diagnostics), user manual link, data sources list, privacy policy, Reset All Settings.

Critical Alerts

Critical Alerts allow Weather Belt to break through Do Not Disturb and Silent mode for life-safety weather events.

  • Default: OFF — must be explicitly enabled by the user.
  • To enable: Settings → Notifications → Critical Alerts → toggle on. iOS will prompt for permission.
  • Once enabled, the following NWS event types will use the critical alert sound regardless of your device's focus or silent settings: Tornado Warning, Tornado Emergency, Flash Flood Emergency, Extreme Wind Warning, Hurricane Warning, Tsunami Warning.
  • All other alerts use standard notifications.
  • This feature required Apple approval and is approved for Weather Belt specifically for life-safety emergency use.
  • Users who prefer not to have alerts break through DND should leave this off.

Privacy & Data

  • Zero personal data collected.
  • No account, no login, no tracking, no analytics.
  • All API keys stored locally using encrypted secure storage.
  • Location used only for map centering and local alert filtering — never transmitted to Ghost Logics or any third party.
  • No data ever sent to Ghost Logics servers.
  • Ad-free. Always.
  • One-time purchase. No subscription. No hidden fees.

FAQ

Q: Do I need an account? A: No. Weather Belt requires no account or login of any kind.

Q: Does it work offline? A: Core features work with cached data. Live feeds (radar, alerts, METAR) require internet to refresh. Reference Library works fully offline.

Q: What AI providers are supported? A: OpenAI (GPT-4o), Anthropic (Claude), and Google Gemini.

Q: Is Broadcastify required for scanner? A: No. OpenMHz provides free scanner audio with no key required. Broadcastify adds live streaming as a premium upgrade.

Q: How do I get a Tomorrow.io key for Lightning? A: Create a free account at tomorrow.io. The free tier provides 25 API calls per hour which is sufficient for normal use.

Q: Why does the app need location permission? A: To center the map, find the nearest weather stations, and filter alerts to your area. Location is never transmitted outside your device.

Q: The risk card shows ALL CLEAR but I can see alerts on the map. Why? A: The risk card only shows alerts within 50 miles of your current location or saved locations. Alerts farther away are visible on the map but won't trigger the home screen risk indicator — this is intentional to keep the home screen relevant to your actual situation.

Q: What triggers the Intelligence banners? A: Incident banner requires 2+ simultaneous signals (NWS alert + IFR conditions + wildfire) within 50 miles. Flood banner requires low elevation (under 100 ft) plus active flood warning. Storm approach requires an active severe warning with NWS-published storm motion data within 200 miles estimating arrival within 3 hours.

Q: How do I reset everything? A: Settings → About → Reset All Settings. This clears all preferences and API keys.

Q: Why does Lightning say "No Tomorrow.io key configured"? A: The Lightning layer requires a free Tomorrow.io API key. Enter it in Settings → Data Sources → Tomorrow.io Key.

Q: What does Critical Alerts do? A: When enabled, tornado warnings, flash flood emergencies, and other life-safety NWS events will sound an alert and wake your screen even if your phone is on Silent or Do Not Disturb. It requires your explicit opt-in in Settings → Notifications.

Q: Does Weather Belt have radar for areas outside the US? A: NEXRAD radar via RainViewer covers the United States. RainViewer also provides international radar coverage in many regions. NWS alerts are US-only. Seismic, wildfire, marine, and lightning data are global.