Audio Visualizer

Amee draws a real-time, audio-reactive visualizer that responds to whatever’s actually playing through your Mac’s speakers — not just from whichever app owns “now playing,” but your system’s actual audio output, so it reacts to anything making sound.

Permission required

The visualizer needs permission to read system audio output, which macOS will prompt for the first time it’s needed. If you don’t see the visualizer reacting to sound:

1. Open System Settings → Privacy & Security, and look for Amee under the audio/screen-recording permission section for your macOS version.
2. Grant the permission.
3. Restart the visualizer — switching skins or relaunching Amee is enough.

This permission is separate from (and narrower than) Screen Recording, even though macOS may group them together in some versions.

Building your own

Skin authors can read the same live audio data Amee’s own built-in visualizer draws from to build a custom visualization. The SDK gives you explicit control:

• amee.startVisualizer() enables the system audio tap that feeds spectrum data — this is what triggers the macOS permission prompt if it hasn’t been granted yet. Rejects if permission is denied.
• amee.onSpectrum(cb) subscribes to real-time FFT magnitude bins once the tap is running.
• amee.stopVisualizer() stops the tap when you no longer need it.

See the SDK reference for full signatures and details.