Setup

Let Lumoi hear your music.

Lumoi paints whatever your computer is playing. On macOS 14.4+ and Windows, it captures your system audio directly — just grant permission the first time. Only older macOS, or routing one specific app, needs a free virtual device.

On macOS 14.4 or later, there's nothing to install. Launch Lumoi with its default System audio input and click Allow when macOS asks to record audio — that's it, no driver. The steps below are only for older macOS (before 14.4), if you declined that permission, or to route one specific source (an app or a DAW) into Lumoi.

  1. Install BlackHole

    BlackHole is a free, open-source virtual audio device. Install the 2-channel version with Homebrew:

    
                          brew install blackhole-2ch
                        

    No Homebrew? Download the installer from existential.audio/blackhole and restart when it asks.

  2. Create a Multi-Output Device

    This lets you keep hearing your speakers while a copy of the sound goes to Lumoi. Open Audio MIDI Setup (Applications → Utilities), click the + in the bottom-left, and choose Create Multi-Output Device. Tick both your speakers/headphones and BlackHole 2ch.

    Keep your speakers at the top as the primary (clock) device, and turn on Drift Correction for BlackHole.

  3. Send your sound to it

    In System Settings → Sound → Output (or the volume control in the menu bar), pick the Multi-Output Device. Now everything you play comes out of your speakers and is mirrored to BlackHole.

  4. Point Lumoi at BlackHole

    Open Lumoi and choose BlackHole 2ch as the audio input. Press play on anything — a track, a set, a video — and Lumoi starts painting it.

Just want what's already playing on Windows? You're done — Lumoi can listen to your system audio directly, no extra setup. The steps below are only for routing a specific source (a particular app, or a DAW) into Lumoi.

  1. Install VB-CABLE

    VB-CABLE is a free virtual audio cable. Download the driver pack from vb-audio.com/Cable, unzip it, right-click the Setup program and Run as administrator, then reboot.

    It installs two devices: “CABLE Input” (a speaker) and “CABLE Output” (a microphone).

  2. Send your sound to the cable

    In Settings → System → Sound → Output, choose CABLE Input as your output device. Your audio now flows into the virtual cable.

  3. Keep hearing it

    Open the classic Sound control panel → Recording tab → CABLE Output → Properties → Listen, tick “Listen to this device”, and pick your speakers or headphones below.

    This monitoring adds a little latency — skip it if you only care about the visuals, not playback.

  4. Point Lumoi at the cable

    Open Lumoi and choose CABLE Output as the audio input. Press play on anything and Lumoi starts painting it.

← Back to Lumoi