How-to

Map the music to any knob

Wire the bass, the beat or the song's energy to any control, then shape how it moves with a curve, a range and smoothing.

4 miniPhone, iPad, Mac

A mapping is one wire: a source (the bass, the beat, a MIDI knob) driving a destination (a knob or a trigger), shaped by a curve, an output range and smoothing. Every reaction you see in ImmerGround is a mapping, including the two each shader starts with. This guide adds one from scratch and explains each part of the card.

Add a mapping

Adding a mapping, switching its source to Bass, giving it an exponential curve, and raising its minimum.
  1. Open the Mappings panel and tap + on its header.
  2. A new card appears with a suggestion already filled in: a control that nothing drives yet, and a music source that suits it. Scroll the cards sideways to see it.
  3. Tap the source chip (left) to change what drives it, and the destination chip (right) to change what it drives.
  4. Tap Curve to shape the response, then set the Min, Max and Smoothing faders.

The mapping runs as soon as it exists. The On switch on each card mutes it without deleting it, which is handy for comparing before and after.

Choose a source

The source picker has three tabs.

Audio bands, read from the Music panel's input:

  • RMS: overall loudness, slow and wide.
  • Bass, Mid, High: low, middle and top of the spectrum.
  • Gate: an envelope that reacts to any loud hit regardless of pitch. Often a better default than Bass for drums.
  • Beat: a discrete event on each detected onset.
  • Spectrum: your own frequency window. Drag a band over the live spectrum, or pick a preset (Sub, Bass, Mid, High, Air), to react to just the hats or just the vocal range.

Smart, read from the song's structure and the Music Clock:

  • Energy: a slow envelope of the song's dynamics, low in breakdowns, high in the drop.
  • Drop: an energy spike above the recent baseline.
  • Beat, Bar, Phrase: every beat, every downbeat, every phrase start, locked to the tempo.
  • Beat ramp, Bar ramp: 0 to 1 across each beat or bar, for smooth pulses and slow sweeps.
  • Section: a new section of the track (a build, a drop). Track change: a new song starts.

MIDI: a controller's knob (CC), note, pitch bend or pad. See Play it with a MIDI controller.

A chip on a source card (for example Motion on Bass) tells you that source already drives something in this project.

Choose a destination

The destination picker has two tabs. Continuous controls are knobs: the scene's own knobs, speed, colour, glitch, blur, strobe and every effect, grouped in chips with counts. Triggers are one-shot events: the same bursts as the Trigger pads, bank slots, and music commands such as next track or tap tempo. Type in the search field to find one by name.

Event sources (Beat, Bar, a MIDI pad) suit triggers. On a knob, an event jumps it, and smoothing decides how fast it falls back.

Shape the response with a curve

CurveWhat it doesGood for
LinearOutput follows input one to oneKnobs you ride by hand
ExponentialSlow start, fast finish: low values barely move, the top end snapsBass on motion: only the real kicks punch through
LogarithmicFast start, slow finish: quiet hits register, loud passages stay calmQuiet material, ambient sets, a mic in a big room
S-CurveSlow at both ends, fast through the middleSmooth, eased movement
CustomYour own power: above 1 leans exponential, below 1 logarithmicFine-tuning one mapping

The curve editor shows a dot riding the line live, so you can watch where the music sits on it before you save.

Set the range and smoothing

  • Min and Max set the output range. Raising Min keeps a knob from ever dropping to nothing; lowering Max keeps it from maxing out on every kick. Most good mappings use a part of the range, not all of it.
  • Smoothing, in seconds, is how long the output takes to follow the input. 0.05 s feels instant, 0.2 s feels like breathing, 1 s and above feels like the song's tide.

Fire a bank slot from a mapping

The Content row on a card binds the mapping to a slot in the project's bank. In Trigger mode, a pad or beat on that mapping then swaps the picture to that clip or photo as well as moving its destination. For several changes on one pad, Pad Scenes are the tidier tool.

Next up
How-to

Play it with a MIDI controller

Plug in a controller, move a knob, and it is mapped. Then fine-tune channels, pads and velocity, or route MIDI from another app.

3 miniPhone, iPad, Mac