Emergency alerts on your screens

When the weather service issues a tornado watch or a flood warning for your area, your screens can show it straight away, without anyone touching the dashboard. You connect ScreenTinker to an official alert feed once. While a warning for your area is live, your screens show it instead of their playlist. When it ends, they go back by themselves.

This guide covers where the alerts come from, how to add a feed, how to narrow it to your area and your screens, how to test it before a real emergency, and what the screens show. Alert feeds use CAP (the Common Alerting Protocol), the format weather services and civil protection agencies publish in.

Before you start

The Emergency feeds page

Choose Emergency feeds under Automate in the sidebar. Each feed is a card. It shows the feed's address, which alerts it lets through, which screens it reaches, what they show, and when it was last Checked. A feed with a live alert has a red edge and says how many alerts are on screens now, with each one listed below.

The Emergency feeds page with two feeds. Flood warnings, Utah is marked Off and says it is not being checked. Weather warnings, Flagstaff has a red edge and says 3 alerts on screens now: an Extreme Tornado Watch, a Severe Flash Flood Warning and a Severe Flood Watch, all issued by NWS Flagstaff AZ. Each card has Check now, Recent alerts, Edit and Delete buttons.
Two feeds: one switched off, one with three live alerts on every screen.

The buttons on each card:

Add a feed

  1. Press Add emergency feed.
  2. Name: something you will recognise, like "Weather warnings, Flagstaff".
  3. Source: where the alerts come from. Pick one:
    • US National Weather Service, by state: type the two-letter state, for example AZ.
    • US National Weather Service, by zone or county code: type a forecast zone or county code, for example WIZ066, for a smaller area.
    • Europe, MeteoAlarm, by country: choose your country from the list.
    • Another CAP feed (address): paste the address of any other agency's CAP feed.
    The full feed address appears under the field, so you can check it.
  4. Show alerts that are: how serious an alert must be to take over your screens. Severe or worse is the default. The other choices are Extreme only, Moderate or worse, Minor or worse and Any severity, including unrated.
  5. Check the feed: every minute, every 2 minutes (the default), every 5 minutes or every 10 minutes.
  6. Narrow it down with the optional filters, choose the screens and what they show, then press Test feed and Save.

The feed is checked as soon as you save it. Untick On to keep a feed without it reaching any screen.

Only your area, only your screens

A whole state or country has warnings most days that don't concern you. Three settings keep the screens for what matters:

What screens show is either The alert card (headline, area, what to do, until when), made from the alert itself, or one of your playlists, for example your own "Shelter in place" slides.

Publish the playlist you pick

Screens play the published version of that playlist. If it has never been published, or it is empty, they show the alert card instead, so a warning never comes up as a blank screen.

Test it before you need it

Test feed fetches the feed now, without saving, and tells you what your settings would do: how many alerts the feed has, and how many would be on screens right now. Each alert is marked would show, filtered out (by your severity, type or area settings) or not current (not started yet, expired, or only a test message).

The Edit
Fourteen alerts for Arizona, but only the three that mention Coconino or Yavapai would reach the screens.

On a quiet day the feed may have no alerts at all. That is normal. Try Any severity, including unrated, or a bigger area, to see that the feed answers, then set it back before you save.

What the screens show

As soon as a matching alert is live, every screen the feed reaches drops what it is playing and shows the alert. It does not wait for the current slide or video to finish. The alert card fills the screen: a coloured band with the severity in words, the type of alert, the headline, the area, what to do, and until when (in the screen's local time). If several alerts are live, they take turns, 15 seconds each.

A full-screen alert card on a dark red background. A red band at the top reads EXTREME, Tornado Watch, 1 / 3. The headline says Tornado Watch issued October 21 at 10:10AM MST until October 21 at 6:00PM MST by NWS Flagstaff AZ, then the area Coconino, Yavapai and Navajo counties and the weather service's text. The footer says Until Wed, Oct 21, 08:00 PM, and NWS.
The alert card. "1 / 3" means two more alerts take their turn after this one.

The words on the card are the agency's own, in the language the feed publishes. When the alert expires, or the agency cancels or replaces it, the screens go back to their normal playlist on their own.

If the feed can't be reached

When a check fails, the card on the Emergency feeds page shows the error, and alerts already on screens stay there until their own end time. A slow agency server never takes a warning off your screens early.

Emergency feeds take over from schedules and from a screen's own playlist. If several of your feeds have live alerts for the same screen, the one with the most severe alert wins. If your organization uses head office (corporate) playlists, an emergency alert that head office activates outranks your feeds.

Recent alerts

Recent alerts on a feed's card opens a table of what the feed has carried in the last week, with the Area, when it runs Until, and its State: On screens, Not shown (filters or time), Cancelled or replaced or No longer in the feed. Use it to answer "why didn't that warning show?" the morning after.

The Weather warnings, Flagstaff card with Recent alerts open. A table with the columns Alert, Area, Until and State lists a Flash Flood Warning for Coconino, AZ marked On screens, and Severe Thunderstorm Warnings for Navajo and Apache counties and Flood Watches for Pinal and Gila counties marked Not shown (filters or time).
Recent alerts: the Coconino warning is on screens; warnings for other counties were filtered out.
On a self-hosted server

Your server fetches the feed itself, so it needs internet access to the agency (api.weather.gov, feeds.meteoalarm.org, or the address you entered). Your screens don't. A feed on your own private network is refused unless the server's OUTBOUND_ALLOW_HOSTS setting names that host, or OUTBOUND_ALLOW_PRIVATE=true is set.

FAQ

Can I show my own emergency message, like a fire evacuation?

Emergency feeds only show alerts that an agency publishes. To let your own systems, such as a fire panel, raise an alert on your screens, use Automation under Automate. If your organization uses head office (corporate) playlists, head office can also activate its own emergency alerts.

My feed shows "Checked" but nothing appears on screen.

That usually means there is no live alert that passes your filters. Open the feed with Edit and press Test feed: each alert says whether it would show or was filtered out. Also check that On is ticked and that Show on includes the screen.

Where do I find my zone or county code?

The US National Weather Service lists its forecast zone and county codes on its website. If you're not sure, use US National Weather Service, by state and put your county's name in Only these areas (optional).

Is this a replacement for official warning systems?

No. Your screens show an alert at the next check after the agency publishes it, so up to the time you chose under Check the feed. Treat it as an extra way to reach people in your building, alongside sirens, phone alerts and radio.

Try it on your own screens

Start a 14-day Pro trial on hosted ScreenTinker: up to 15 screens, every feature, no credit card.

Start your free trial

Or host it yourself, free and open source: self-hosting guide · GitHub