Setup

Let Lumoi hear your music.

Lumoi paints whatever your computer is playing. Neither macOS nor Windows lets one app capture another's sound directly, so you route your audio through a free virtual device — BlackHole on macOS, VB-CABLE on Windows. It's a quick, one-time setup.

  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