LIQUIDWAVE · Help
Support
Most questions come down to one macOS permission. If yours doesn't, write to hello@liquidwave.app. We usually answer within a few business days.
Requirements
LIQUIDWAVE requires macOS 14.2 (Sonoma) or later and runs natively on both Apple Silicon and Intel Macs. System-audio capture uses Core Audio Taps, the system API Apple introduced in macOS 14.2. No virtual audio drivers, no kernel extensions.
“LIQUIDWAVE isn't hearing anything”
If music is playing but the visualizer sits still, macOS is most likely not letting LIQUIDWAVE hear it. Open System Settings → Privacy & Security → Screen & System Audio Recording (on older versions of macOS: Microphone), enable LIQUIDWAVE, then press Retry on the badge or switch the source off and back on in the app. The badge also appears when the player is simply paused. The prompt appears only once, so if it was dismissed the switch stays off until you flip it here.
Apple Music shows nothing
DRM-protected streams, on Apple Music and elsewhere, are silenced by macOS for every capture API, LIQUIDWAVE included. This is the operating system enforcing the content license, not a bug. Purchased or DRM-free tracks visualize normally, and Listen Mode (the microphone path) works with anything your speakers are playing.
Choosing a source
The bottom transport switches between System (everything your Mac plays) and Listen (the microphone, tuned for turntables, cassette decks, radio, and the room itself), with Ambient beside them for when you want the scenes to move with no input at all.
Keyboard
- ↑ / ↓Cycle styles
- ← / →Cycle scenes within the active style
- ⌃⌘FFull screen
The on-screen controls appear when you move the mouse and fade out four seconds after it stops.
Contact
Bug reports, feature requests, a scene you wish existed, anything else: hello@liquidwave.app. Please include your macOS version and, for audio issues, the source you were using.