How kareemsasa3/aether works
Aether publishes real-time audio analysis from a PipeWire-backed daemon through a seqlock shared-memory contract. Consumers include the query client, terminal visualizer, RGB controller, and desktop integrations. The graph preserves these branches and the visualizer’s state, rendering, overlays, and style system; some integration links are documented rather than source-inspected.
Main entry points: aether_client.py Query Client · aether.py TUI Runtime · aether_shm.py Seqlock Memory · aether_daemon.py Audio Daemon
Components 23
Audio Publisher
- Audio Daemon
aether_daemon.py - Audio Config
aether_config.py
Shared Data Contract
- Seqlock Memory
aether_shm.py - Query Client
aether_client.py
Reference Consumers
- RGB Controller
aether_rgb.py
Terminal Visualizer
- TUI Runtime
aether.py - Signal State
engine.py - Terminal Rendering
render.py - Menus
ui/overlays.py - Style Catalog
style_catalog.py - Style Plugins
styles
Desktop Integrations
- Hue Sync
integrations/hue/aether-hue-sync.py - Discord Presence
integrations/discord/aether-discord-rpc.py - OBS Ducking
integrations/obs/aether-obs-ducking.py - Notification Pauser
integrations/dunst/aether-pause-daemon.py - Status Bar Scripts
integrations
Other components
- PipeWire
- CLI User
- OpenRGB
- Hue Bridge
- Discord
- OBS Studio
- Dunst
Connections 25
- PipeWire → Audio Daemon: provides audio
README.md - Audio Daemon → Audio Config: reads settings
aether_daemon.py - Audio Daemon → Seqlock Memory: publishes snapshots
README.md - Query Client → Seqlock Memory: reads snapshots
aether_client.py - CLI User → Query Client: queries bands
aether_client.py - CLI User → TUI Runtime: launches
README.md - TUI Runtime → Seqlock Memory: reads events
aether.py - TUI Runtime → Signal State: updates state
aether.py - TUI Runtime → Terminal Rendering: draws frames
aether.py - TUI Runtime → Menus: opens menus
aether.py - TUI Runtime → Style Catalog: loads styles
aether.py - Menus → Style Catalog: lists styles
ui/overlays.py - Style Catalog → Style Plugins: loads plugins
style_catalog.py - CLI User → RGB Controller: launches
README.md - RGB Controller → Seqlock Memory: reads snapshots
aether_rgb.py - RGB Controller → OpenRGB: controls LEDs
README.md - Hue Sync → Query Client: reads bands
integrations/hue/aether-hue-sync.py - Hue Sync → Hue Bridge: updates lights
integrations/hue/aether-hue-sync.py - Discord Presence → Query Client: reads bands
integrations/discord/aether-discord-rpc.py - Discord Presence → Discord: updates presence
integrations/discord/aether-discord-rpc.py - OBS Ducking → Query Client: reads energy
integrations/obs/aether-obs-ducking.py - OBS Ducking → OBS Studio: adjusts volume
integrations/obs/aether-obs-ducking.py - Notification Pauser → Query Client: reads bass
integrations/dunst/aether-pause-daemon.py - Notification Pauser → Dunst: pauses alerts
integrations/dunst/aether-pause-daemon.py - Status Bar Scripts → Query Client: reads status
README.md