Git Product home page Git Product logo

eas-alert-bot's Introduction

EAS Alert Bot

EAS Logo

What is this?

This is a small bot for recording and relaying, in near real time, United States Emergency Alert System alerts to a Discord webhook, using the SAMEDec Rust package, ffmpeg, cURL, and dsame3. This is how it works (roughly):

  1. Listens for EAS tones from an input using ffmpeg, meaning the input can be anything, either attached to your local computer you're running the bot on (something like a capture card) or an external source (such as a live audio stream).
  2. Receives the EAS tones using SAMEDec.
  3. Records the EAS alert using ffmpeg (to the directory C:\EAS_Alerts).
  4. Sends the demodulated header to dsame3 for a human-readable message.
  5. Sends the header AND human-readable message to Discord via a simple cURL request.
  6. Logs the received alert to a central file (alert_log.txt in the directory you're running the bot from).

Why?

Like a (somewhat surprising) number of other people, I am interested in the concept of the EAS and civil defense broadcasting in general. Any way to relay alerts like this, in (almost) real time no less, is especially interesting and cool to me personally.

How to install it?

The recommended way to install everything is via Chocolatey, a Windows-based package manager. (Did I mention this whole thing was built with Windows in mind?)

Steps:

  1. Install Chocolatey from the link above.
  2. Run the following command to get all the pre-requisite software: choco install ffmpeg curl rust python3.
  3. Further install SAMEDec by running cargo install samedec.
  4. Install the requirements for dsame3 by going into the dsame3 folder and running pip install -r requirements.txt.
  5. Edit record_and_send.bat AND main.bat to add your webhook and capture method's information. More info on this step is in the wiki.
  6. Run start_here.bat. This file will only need to be run once, to test everything and download the models for dsame3. Assuming you see a message in Discord and something recorded from your preferred capture device, you're good to go for the final step:
  7. Add a scheduled task in Task Scheduler. Once this is done, this bot will run on boot and run in the background silently. More info on this step in the wiki.

Disclaimers

Like SAMEDec and dsame3's README's state: THIS BOT IS NOT FOR USE IN SAFETY-CRITICAL APPLICATIONS WHERE IT COULD MEAN INJURY OR DEATH MAY OCCUR!!! ALWAYS, ALWAYS, ALWAYS HAVE MULTIPLE METHODS TO RECEIVE EMERGENCY ALERTS. Think of this bot ONLY as a fun little toy, NOT a proper EAS ENDEC to alert the public in life-threatening situations.

Who am I?

I'm Wags, and I make a variety of things for the Internet. You can find my personal website here. I even have a blog (BlARG) post about the EAS located here for your perusal.

eas-alert-bot's People

Contributors

wagwan-piffting-blud avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.