AC Event Daemon#

A UDP notification listener that displays giant word overlays for aesthetic-computer notifications.

Features#

🔄 UDP notification listener (port 9999)
🌐 Web-based overlay system using aesthetic.computer
🖥️ Giant word overlays with multiple fallback methods:
- Web overlay via aesthetic.computer/overlay.html (primary)
- Local HTML file fallback
- Terminal output (disabled by default)
🎨 Color-coded notifications: success, error, info, warning
🐧 Linux/Wayland friendly with fractional scaling support
📦 Container compatible
🛡️ Robust signal handling (auto-stops when terminal closes)
👤 Root user safety and clean output
🎯 Minimal terminal output (use DAEMON_VERBOSE=1 for debug)

Usage#

Start the daemon:#

cd ac-event-daemon
./start-daemon.sh
# OR
cargo run

Send notifications:#

./ac-notify success "Task completed"
./ac-notify error "Something failed"  
./ac-notify info "Information"
./ac-notify warning "Be careful"

# Verbose mode (shows debug info)
VERBOSE=1 ./ac-notify success "Debug mode"

Test web overlay:#

./test-web-overlay.sh

Daemon verbose mode:#

DAEMON_VERBOSE=1 ./start-daemon.sh

Safe daemon startup (handles root permissions):#

cd ac-event-daemon
./start-daemon-safe.sh

UDP Protocol#

The daemon listens for UDP messages on port 9999 with the format:

prompt-complete:<type>

Where <type> can be:

success - Green overlay with ✨ SUCCESS ✨
error - Red overlay with ❌ ERROR ❌
info - Blue overlay with ℹ️ INFO ℹ️

System Requirements#

Rust/Cargo
Linux with UDP networking
Optional: rofi, gxmessage, notify-send for overlays
Optional: Browser (firefox, chromium, etc.) for HTML overlays

Architecture#

ac-event-daemon: Rust UDP listener with overlay display
ac-notify: Bash script for sending notifications
Fallback chain: HTML → rofi → gxmessage → system notification

The system is designed to work in various environments including containers and headless systems.