Skip to content
Onyx

Open source Audio-reactive visuals

See thesound.

Lumina is a native macOS music player built around a real-time, audio-reactive Metal visualizer — architected so any source, from local files to DRM streaming, drives the same field of light.

The problem

Visualizers go blind on the good stuff

Most visualizers can only react to audio they decode themselves, so protected streaming — Apple Music, Spotify — gets no visuals at all. Lumina taps the Mac's post-mix output through a Core Audio process tap (macOS 14.4+), so the picture reacts to whatever is actually playing, no matter where the sound came from.

Capabilities

What Lumina does, precisely.

Two paths to the waveform

A playback-engine tap reads raw PCM from local files; a system-audio tap captures the Mac's output post-mix. Switch between them live — the second works with anything, DRM included.

A particle field, driven by frequency

An Accelerate/vDSP FFT resolves 64 log-spaced bands plus bass, mid, and treble energy, feeding an additive GPU particle field that pulses at a steady 60fps.

Any source, one boundary

Everything visual depends on a single MusicSource protocol. Local playback works today; Apple Music, Spotify, and NetEase slot in behind the same clean seam without the visuals ever caring.

Small files, on purpose

Every part is a single-responsibility Swift file — the deliberate opposite of the monolith it learned from. Read it, fork it, learn from it.

Interface studies — Lumina for macOS

See the sound.

Lumina is free and open source — Anthony-Pan/Lumina.