You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 4-6.RSVP
Socket
Book a DemoInstallSign in
Socket

EASGen-Remastered

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

EASGen-Remastered

A Python library to generate EAS SAME Audio using Raw Data - Remastered

0.1.14.1
pipPyPI
Maintainers
1

🌩️ EASGen: A Fast Python EAS Generation Library

EASGen

EASGen is a powerful Python library for translating EAS (Emergency Alert System) ZCZC strings or other data into SAME (Specific Area Messaging) headers. It includes robust support for individual headers, attention tones, EOM generation, emulation modes, and WEA tone generation, ensuring a seamless experience for encoding emergency messages.

🛠️ Features

  • EAS Generation: Converts raw ZCZC SAME strings into Individual headers, attention tones. Also allows generation of EOMs.
  • PyDub AudioSegment Output: Provides easy integration through PyDub AudioSegments.
  • Audio File Input: Allows for audio files to be input to allow for audio messages and other forms of audio injection.
  • Very Quick: Generates headers quickly and efficiently, allowing for high performance usage.
  • Emulation Modes: Mimic the sound of various EAS hardware/software systems.

🚀 Installation

Linux (Debian-based)

sudo apt update
sudo apt install python3 python3-pip
python3 -m pip install EASGen-Remastered

Windows

  • Install Python.
  • Open CMD and run:
    python -m pip install EASGen-Remastered
    

📖 Basic Usage

Generate a simple SAME Required Weekly Test:

from EASGen import EASGen
from pydub.playback import play

header = "ZCZC-EAS-RWT-005007+0015-0010000-EAR/FOLF-" ## EAS Header to send
Alert = EASGen.genEAS(header=header, attentionTone=False, endOfMessage=True) ## Generate an EAS SAME message with no ATTN signal, and with EOMs.
play(Alert) ## Play the EAS Message
Output

https://github.com/user-attachments/assets/ef98a6a8-a85d-4c7d-a8af-ed52740e7be7

🔍 Advanced Usage

To Insert Audio into an alert:

from EASGen import EASGen
from pydub.playback import play
from pydub import AudioSegment

header = "ZCZC-CIV-DMO-033000+0100-0010000-EAR/FOLF-" ## EAS Header to send
audio = AudioSegment.from_wav("NewHampshireDMO.wav") ## Alert Audio import
Alert = EASGen.genEAS(header=header, attentionTone=True, audio=audio, endOfMessage=True) ## Generate an EAS SAME message with an ATTN signal, the imported WAV file as the audio, and with EOMs.
play(Alert) ## Play the EAS Message
## The New Hampshire State Police has activated the New Hampshire Emergency Alert System in order to conduct a practice demo. This concludes this test of the New Hampshire Emergency Alert System.
Output

https://github.com/user-attachments/assets/f87d34eb-9604-4389-9bee-04b055bcb938

Spamming New Hampshire Demos have never been easier!

For a custom SampleRate:

from EASGen import EASGen
from pydub.playback import play
from pydub import AudioSegment

header = "ZCZC-EAS-DMO-055079+0100-0010000-EAR/FOLF-" ## EAS Header to send
Alert = EASGen.genEAS(header=header, attentionTone=True, endOfMessage=True, sampleRate=48000) ## Generate an EAS SAME message with an ATTN signal, the imported WAV file as the audio, with EOMs, at a samplerate of 48KHz.
play(Alert) ## Play the EAS Message
Output

https://github.com/user-attachments/assets/97c9b41e-1c44-4ba2-8077-e13786373378

To export an alert instead of playing it back:

from EASGen import EASGen
from pydub import AudioSegment

header = "ZCZC-EAS-RWT-055079+0100-0010000-EAR/FOLF-" ## EAS Header to send
Alert = EASGen.genEAS(header=header, attentionTone=True, endOfMessage=True, sampleRate=48000) ## Generate an EAS SAME message with an ATTN signal, the imported WAV file as the audio, and with EOMs.
EASGen.export_wav("Alert.wav", Alert)
Output

https://github.com/user-attachments/assets/becc78e7-204b-478b-bc7a-213178affc61

To resample an alert after generation (If sampleRate is making the audio weird):

from EASGen import EASGen
from pydub.playback import play
from pydub import AudioSegment

header = "ZCZC-EAS-DMO-055079+0100-0010000-EAR/FOLF-" ## EAS Header to send
Alert = EASGen.genEAS(header=header, attentionTone=True, endOfMessage=True) ## Generate an EAS SAME message with an ATTN signal, the imported WAV file as the audio, and with EOMs.
Alert = Alert.set_frame_rate(8000) ## Resample the alert to 8KHz for no reason lol.
play(Alert) ## Play the EAS Message
Output

https://github.com/user-attachments/assets/fdc0fe4e-6a25-47a0-a839-6c0270e94178

To simulate an ENDEC type:

from EASGen import EASGen
from pydub.playback import play
from pydub import AudioSegment

header = "ZCZC-CIV-DMO-033000+0100-0010000-EAR/FOLF-" ## EAS Header to send
audio = AudioSegment.from_wav("NewHampshireDMO.wav") ## Alert Audio import
Alert = EASGen.genEAS(header=header, attentionTone=True, audio=audio, mode="DIGITAL", endOfMessage=True) ## Generate an EAS SAME message with an ATTN signal, the imported WAV file as the audio, with EOMs, and with a SAGE DIGITAL ENDEC style.
play(Alert) ## Play the EAS Message
## The New Hampshire State Police has activated the New Hampshire Emergency Alert System in order to conduct a practice demo. This concludes this test of the New Hampshire Emergency Alert System.
Output

https://github.com/user-attachments/assets/ac28d2e3-b3a2-45f6-bf63-dfb86b6e5aa5

Now you can make all the Mocks you want!

Supported ENDECS:

  • None
  • TFT (Resample to 8KHZ using ".set_frame_rate(8000)" on the generated alert)
  • EASyCAP (Basically the same as None)
  • DASDEC (Crank up the Samplerate to 48000 for this one)
  • SAGE EAS ENDEC (Mode = "SAGE")
  • SAGE DIGITAL ENDEC (Mode = "DIGITAL")
  • Trilithic EASyPLUS/CAST/IPTV (Mode = "TRILITHIC")
  • NWS (Mode = "NWS", Resample to 11KHZ using ".set_frame_rate(11025)" on the generated alert)

Unsupported ENDECS:

  • HollyAnne Units (Can't sample down to 5KHz... This is a good thing.)
  • Gorman-Reidlich Units (Don't listen to them enough to simulate. I think they're like TFT, but donno.)
  • Cadco Twister Units (No Data)
  • MTS Units (No Data)

To hear all the ENDEC styles, do this:

from EASGen import EASGen
from pydub.playback import play
from pydub import AudioSegment

print("Normal / EASyCAP")
play(EASGen.genEAS("ZCZC-EAS-DMO-055079+0100-0391810-EAR/FOLF-", True, True, AudioSegment.empty(), "", 24000, False))
print("DAS")
play(EASGen.genEAS("ZCZC-EAS-DMO-055079+0100-0391810-EAR/FOLF-", True, True, AudioSegment.empty(), "", 48000, True))
print("TFT")
play(EASGen.genEAS("ZCZC-EAS-DMO-055079+0100-0391810-EAR/FOLF-", True, True, AudioSegment.empty(), "", 24000, True).set_frame_rate(8000))
print("NWS")
play(EASGen.genEAS("ZCZC-EAS-DMO-055079+0100-0391810-EAR/FOLF-", True, True, AudioSegment.empty(), "NWS", 24000, True).set_frame_rate(11025))
print("SAGE")
play(EASGen.genEAS("ZCZC-EAS-DMO-055079+0100-0391810-EAR/FOLF-", True, True, AudioSegment.empty(), "SAGE", 24000, True))
print("DIGITAL")
play(EASGen.genEAS("ZCZC-EAS-DMO-055079+0100-0391810-EAR/FOLF-", True, True, AudioSegment.empty(), "DIGITAL", 24000, True))
print("EASyPLUS/CAST/IPTV")
play(EASGen.genEAS("ZCZC-EAS-DMO-055079+0100-0391810-EAR/FOLF-", True, True, AudioSegment.empty(), "TRILITHIC", 24000, True))
Output

https://github.com/user-attachments/assets/e56a3f58-20d0-4594-a6bd-e0cdece92540

https://github.com/user-attachments/assets/6ba4db6e-cd2f-4a15-a3d4-9f579abfbfbc

https://github.com/user-attachments/assets/9b4e4131-fbbb-4630-81bf-bba480483d77

https://github.com/user-attachments/assets/58a57f4b-5eac-442b-bcac-8de6c9e759e2

https://github.com/user-attachments/assets/9e987f1a-5c9b-4e48-94e6-6254df09af6a

https://github.com/user-attachments/assets/ca9918ec-78ea-4612-99ee-923bfe695bc0

https://github.com/user-attachments/assets/0e80b6e9-a53b-4d88-94e9-4d44f6f3019f

To generate ATTN only alerts, such as NPAS or WEA:

For NPAS:

from EASGen import EASGen
from pydub.playback import play
from pydub import AudioSegment

Alert = EASGen.genATTN(mode="NPAS") ## Generate an NPAS (AlertReady) Tone
play(Alert) ## Play the NPAS Tones
Output

https://github.com/user-attachments/assets/9f22a1a7-dd22-4e1a-89b4-179a38cd2206

For WEA:

from EASGen import EASGen
from pydub.playback import play
from pydub import AudioSegment

Alert = EASGen.genATTN(mode="WEA") ## Generate WEA Tones
play(Alert) ## Play the WEA Tones
Output

https://github.com/user-attachments/assets/cfd3df91-053d-445b-a84e-79bdb2b9ca72

To use the Bandpass Filter functionality:

from EASGen import EASGen
from pydub.playback import play
from pydub import AudioSegment

header = "ZCZC-CIV-DMO-033000+0100-0010000-EAR/FOLF-" ## EAS Header to send
Alert = EASGen.genEAS(header=header, attentionTone=True, mode="DIGITAL", endOfMessage=True, bandpass=True) # New BandPass feature, which improves the audio quality on some emulation modes.
play(Alert) ## Play the EAS Message
Output

https://github.com/user-attachments/assets/511d82af-7c71-4e09-89e3-25b51c461b18

⚠️ Reporting Issues

  • Bugs and other issues can be reported on Discord or in the GitHub Issues tab.
  • Include entire ZCZC SAME strings and any Audio Files injected and details for accurate and quick fixes.

📜 License

MIT License

👤 Contact

  • Developer: SecludedHusky Systems/Newton Communications
  • Discord: Contact Here

❤️ Thank You for Using My Version of EASGen!

Powered by SecludedHusky Systems. Get affordable internet radio services and VPS hosting today.

Keywords

audio sound eas alerting emergency-alert-system

FAQs

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts