HELP

Frequently Asked
Questions

Everything you need to know about StormSync, NWWS-OI, and getting set up.

What is NWWS-OI?

NWWS-OI (NOAA Weather Wire Service — Open Interface) is an authenticated XMPP feed operated by the National Weather Service. It delivers every NWS text product in real time — the same feed used by TV broadcasters and emergency management agencies.

How do I get NWWS-OI credentials?

Email NWWS.Issue@noaa.gov. Credentials are free and typically issued within 10–30 days.

Do I need a StormSync key AND NWWS-OI credentials?

Yes — they are separate. The StormSync key unlocks the download. Your NWWS-OI credentials connect the app to the live feed via config/config.yaml.

How do I request a StormSync key?

Email contact@stormsyncapp.com. Keys are free, typically issued within 24–48 hours.

Is StormSync affiliated with NOAA or the NWS?

No. StormSync is independent and not affiliated with, endorsed by, or associated with NOAA, the NWS, or any government agency.

What do I need before running StormSync?

Python 3.10 or newer from python.org — check "Add Python to PATH". Everything else is handled by install.bat.

install.bat failed — what do I do?

Run .venv\Scripts\activate then pip install -r requirements.txt manually. Email contact@stormsyncapp.com with your log if still stuck.

Where do I put my credentials?

Open config/config.yaml and fill in username and password under the xmpp section.

Can I run it on Mac or Linux?

Windows only for now. Mac and Linux support is planned — see the Roadmap.

How fast are alerts compared to other apps?

NWWS-OI delivers within seconds of issuance. The public REST API adds 60–120 seconds. Push notifications can be 3–10 minutes behind.

The app shows no alerts.

Check credentials in config/config.yaml and review nwws_monitor.log. During quiet weather periods very few products are issued — this is normal.

Is my data sent anywhere?

No. All alert history is stored locally in SQLite on your machine. Nothing is shared with us or any third party.

What does the severity rank mean?

A priority score from 1–115 for sorting alerts and triggering audio. Tornado Emergency is 115. It is a StormSync-specific scale with no official NWS meaning.

Can I use this for emergency management?

StormSync is provided as-is with no warranty. Do not rely solely on this application for life-safety decisions.