Winamp audio watchdog

WinampAudioWatchdog

Malý watchdog pro Windows, který hlídá skutečný audio výstup přes WASAPI loopback.
Když je na výstupu delší dobu ticho, automaticky restartuje Winamp.

Stažení

K dispozici jsou hotové instalátory pro 32bit i 64bit Windows:

Poznámka: i když je Winamp obvykle 32bit, watchdog může být klidně 64bit.
Pro běžná 64bit Windows je tedy verze amd64 v pořádku.

Proč to vzniklo

V praxi se občas stane, že Winamp sice běží, ale stream se zasekne nebo přestane hrát.
Externí silence detektory nebývají vždy spolehlivé, protože často nehlídají skutečný zvuk,
ale jen stav procesu nebo přítomnost streamu. Tohle řešení naopak sleduje
reálný audio výstup Windows.

Jak to funguje

Program průběžně měří úroveň zvuku na výstupu systému. Pokud je hlasitost pod nastaveným prahem
déle než definovaný čas, provede automatický restart Winampu:

  1. ukončí winamp.exe
  2. počká několik sekund
  3. spustí Winamp znovu
  4. načte playlist nebo URL streamu
  5. po restartu chvíli nezasahuje, aby Winamp stihl nabufferovat

Volitelně umí navíc kontrolovat i dostupnost Icecast URL přes HTTP healthcheck,
ale hlavní rozhodování je založené na skutečném zvuku.

Hlavní vlastnosti

  • hlídání skutečného audio výstupu přes WASAPI loopback
  • automatický restart Winampu při delším tichu
  • možnost automaticky spustit Winamp, pokud neběží
  • volitelný HTTP healthcheck streamu
  • logování do souboru
  • volitelná e-mailová upozornění
  • hotové instalační balíčky pro Windows

Příklad konfigurace

Konfigurace je v souboru config.json. Níže je ukázkový obsah:

{
  "WinampPath": "C:\\Program Files (x86)\\Winamp\\winamp.exe",
  "PlaylistOrUrl": "C:\\radio\\stream.m3u",
  "LogFile": "C:\\radio\\winamp-watchdog.log",

  "SilenceThresholdDb": -45.0,
  "SilenceSeconds": 30,
  "RestartCooldownSeconds": 90,

  "RestartIfWinampNotRunning": true,
  "StartWinampOnLaunchIfMissing": true,

  "StreamHealthcheckUrl": "",
  "StreamHealthcheckIntervalSeconds": 30,
  "StreamHealthcheckTimeoutSeconds": 8,
  "StreamHealthcheckFailThreshold": 3,

  "AlarmAfterRestarts": 3,
  "RestartWindowMinutes": 10,

  "EmailRecipients": [],
  "EmailFrom": "",
  "SmtpHost": "",
  "SmtpPort": 587,
  "SmtpEnableSsl": true,
  "SmtpUsername": "",
  "SmtpPassword": ""
}

Doporučené výchozí nastavení

Pro první test se osvědčí začít takto:

  • SilenceThresholdDb: -45
  • SilenceSeconds: 30
  • RestartCooldownSeconds: 90

Pokud watchdog falešně restartuje při tichých pasážích, zkus:

  • zvýšit SilenceSeconds na 45 až 60
  • nebo snížit citlivost na SilenceThresholdDb třeba na -50

Pokud naopak nereaguje na skutečný výpadek, zkus:

  • SilenceThresholdDb nastavit třeba na -40

E-mailová upozornění

Watchdog umí po restartu Winampu poslat informační e-mail. Stačí doplnit:

  • EmailRecipients – seznam adres
  • EmailFrom
  • SmtpHost
  • případně SmtpUsername a SmtpPassword

Prázdný seznam adres e-maily vypíná. Pokud SMTP server vyžaduje TLS/STARTTLS,
použij typicky port 587 a SmtpEnableSsl: true.

Pozor: heslo k SMTP je v konfiguraci uloženo jako prostý text,
takže je dobré omezit přístup k souboru config.json.

Instalace a spuštění

Po instalaci může struktura vypadat například takto:

C:\radio\
  WinampAudioWatchdog.exe
  config.json
  stream.m3u

Spuštění z příkazové řádky:

C:\radio\WinampAudioWatchdog.exe C:\radio\config.json

Automatický start po bootu

Nejjednodušší je použít Task Scheduler:

  1. vytvoř novou úlohu (Create Task)
  2. nastav trigger: At startup nebo At log on
  3. nastav akci:
    • Program: C:\radio\WinampAudioWatchdog.exe
    • Arguments: C:\radio\config.json
    • Start in: C:\radio
  4. pokud chceš běh bez přihlášení, zaškrtni Run whether user is logged on or not

Je ale potřeba počítat s tím, že WASAPI loopback potřebuje aktivní audio zařízení.
Na některých Windows je proto spolehlivější spouštět watchdog až po přihlášení uživatele,
ne jako čistou službu bez desktop/audio session.

Jak otestovat funkčnost

  1. spusť Winamp se streamem
  2. spusť watchdog
  3. zastav stream nebo dej ve Winampu Stop
  4. po uplynutí SilenceSeconds by měl watchdog zapsat ticho do logu a restartovat Winamp

Překlad do EXE na Linuxu

Pokud si chceš program přeložit sám, potřebuješ .NET SDK.

dotnet restore
dotnet publish -c Release -r win-x64 --self-contained true \
  /p:PublishSingleFile=true \
  /p:EnableCompressionInSingleFile=true

Pro 32bit Windows stačí místo win-x64 použít win-x86.

Vytvoření NSIS instalátoru na Linuxu

Pokud máš v projektu připravené skripty pro build instalátorů, nejjednodušší postup je:

bash build-installers.sh

Tím vzniknou instalační balíčky pro obě architektury.


Stažení instalátorů

Pokud chceš jen hotovou verzi bez kompilace, stáhni instalátor podle architektury systému:

WinampAudioWatchdog je volně použitelný nástroj určený hlavně pro dohled nad
přehráváním streamu na Windows strojích, kde je důležité hlídat skutečný audio výstup.

Příspěvek byl publikován v rubrice Nezařazené. Můžete si uložit jeho odkaz mezi své oblíbené záložky.