Perennos DEAD AIR

Install, open, done

1. Install

   You need Python 3.11 or newer, plus FFmpeg and ffprobe on your PATH. Dead Air does not install system binaries or run an administrator command for you. Get the source, then install FFmpeg yourself; package availability depends on your machine.

   git clone https://github.com/Perennos/dead-air.git
   cd dead-air

   winget install --id Gyan.FFmpeg.Shared -e   # Windows
   sudo apt install ffmpeg                       # Debian, Ubuntu
   sudo dnf install ffmpeg                       # Fedora

   Make sure ffmpeg and ffprobe both resolve from a new terminal. Only a YouTube source needs the optional yt-dlp adapter; the README on GitHub covers it.

2. Open

   Check the example configuration. This only parses the example file: it does not check FFmpeg, contact a source, capture media, send a notification, or prove production readiness.

   python dead_air.py validate --config dead-air.example.toml

3. Done

   Copy the example to a private configuration file and add only streams you own or are authorized to monitor. Then run a short watch, or the foreground 24/7 path.

   python dead_air.py watch --config dead-air.toml --max-cycles 3 --json
   python dead_air.py watch --config dead-air.toml --continuous --json

   Continuous mode is not evidence of a completed 24-hour soak or of production readiness. Test it on your own authorized streams before you rely on it.

What it won't do

• It does not control a stream, restart an encoder, change broadcast scenes or operate OBS. Its commands report observations.

• It does not import browser cookies or sign in to stream accounts. A public URL is not a promise that a provider will expose usable media.

• It is not a hostile-URL sandbox. It trusts operator-owned configuration and local tool paths, so do not feed it untrusted URLs or configurations. Public targets are the default; private and loopback targets are denied unless you opt in and name them. TLS certificate verification stays on.