mubone — simulation (preview)

--,--

buffers: 0

↓

drop audio file (.wav, .mp3, .ogg)

session

erase

follows cursor · radius + recency

audio

input

in gain

gate

dry mon

dry gain

master

lens

selection

order

area

radius

depth

soft edge

curve

grain

envelope

dur

period

overlap

curve

fade %

variation

dur ±

per ±

start ±

dur jit

prob

pitch

pitch ±

dir

filter

type

cutoff

res

flt ±

output

spread

vol

cursor

trace

params

azimuth

elevation

commits

0 / 8

mode ⇧D

drop cloud D

draw cloud hold D

params

With follow on in the rail, the faders follow the cursor: the nearest pin is loudest and the rest hand over by distance.

Crossfade How far one pin blends into the next. 100% blends all the way; 0% cuts at the midpoint.

Every Pin

How pins come and go. Read at the moment it happens, so a change reaches every pin at once.

In How a pin comes up — on pin, and on unmute.

Out How a pin leaves — on unpin, and on mute. A loop never under its declick.

A New Pin

What a pin is born with, and keeps.

Path Which way a moving pin travels along its own path.

loop

vol

speed

release

fade ms

trigger

record trigger

hold ⇧space to record one

dwell

start

release

reach search radius

chop

retrig

rearm

vol

speed

LED Feedback

Drive The LED Only the sensor holding the cursor role animates; the others get one solid idle write.

States

One state is active at a time, held for as long as its condition is true.

Events

An event fires once, interrupts the running state, then the state resumes.

Reference

Read once. Nothing here changes as you work.

Patterns. solid holds a colour. slow (1.5 Hz) and fast (5 Hz) blink, pulse breathes through eight steps, flash is the 90 ms blip events use, and strike is a shorter, percussive one — the tape line's. An event's count is how many times its pattern repeats.

⇄ timbre. The interleaves alternate the row's colour with the live scan timbre instead of with black, so the LED carries two facts at once — mute's slow ⇄ timbre says the output is dead and what you would be hearing. The plain timbre pattern is offered on scan alone: it paints the colour the visualiser gives the particles the cursor would fire from now, and falls back to idle when nothing is in radius.

Rate. Messages per second to the sensor while the row runs. Neither the x-imu3 nor the mubone instrument blinks on its own, so every edge is a message from here, sharing the radio with inbound data over Wi-Fi. If raw readings start looking glitchy, this column is the first place to look.

Disabling. A disabled state falls back to idle rather than to the firmware's own colour. Disabling idle itself releases the override: an x-imu3 goes back to its firmware's colour, and the mubone instrument, which has none, goes dark.

Keys + MIDI

Bindings

One row per action. The OSC address and what it accepts sit under the action’s own name — they describe the same thing.

Shown On The Palette Which binding each tile wears as its sticker; the table below shows all three.

ActionKeyboard · SensorButtonMIDIScale

Ports

Where control arrives. Turn MIDI off on any station driven by OSC — one shared pedal is otherwise heard by every instance at once.

MIDI Input Every attached device, on every channel — a binding names its own channel. —

OSC Input Any OSC sender reaches this station, on UDP 127.0.0.1:7500. solo

—

Live Monitor

Every inbound message while this page is open.

MIDI 0

OSC 0 pause

Reference

Read once. Nothing here changes as you work.

Scale. min and max set where the two ends of a controller’s travel land, in the destination’s own units; γ distributes the travel between them. A destination that curves its own output starts at that number rather than 1 — the paint gate reads γ3. Double-click γ for full travel and the destination’s own curve.

What an address accepts. bang takes no argument — just the address. int n|m is an integer with listed options; float a–b u a range in unit u.

Bangs. Over OSC, send the address with no args. Over MIDI, a bang fires once on press and the matching value-0 release is dropped — so a trigger-mode pedal that sends 127 then 0 produces exactly one action per tap. Note-on fires, note-off is ignored.

Multi-station. Each station listens on its own port — a=7500, b=7510, c=7520 — so a sender addresses a station by port; there is no relay in between.

sensor setup

0 sensors wifi none · usb none · osc none

Cursor

How the cursor reads, past what the rail holds.

Falloff With soft edge on, how steeply grains fade toward the radius's edge. 0% is linear.

Tape

What a take does when the cursor arrives, and how it is cut.

Start Where a take begins when it fires: its top, the point you touched, or the end you arrive at.

Release How a take stops when you leave it — play to the end of the pass, stop at once, or fade out.

Release Fade How long a take's fade takes, with release set to fade.

Rearm The least gap before the same take can fire again. Stops a hovering cursor retriggering it.

Min Slice With slice on, a segment shorter than this merges into the one before it.

Dub Decay With overdub on, how much the loop steps down each pass. 0 keeps every layer at full.

Grain

What a walking stroke does when the cursor arrives, while walk on touch is on.

Start Where a walker begins: the stroke's top, the point you touched, or the end you arrive at.

Release How a walker stops when you leave its stroke — play to the end of the pass, or fade out.

Release Fade How long a walker's fade takes, with release set to fade.

Rearm The least gap before the same stroke can be walked again.

Camera

How the view is steered. Distance is on the Visuals page.

Mode Steer follows the mouse; surface captures it; sensor hands the view to the x-imu3.

Display

Where the sphere is shown, and what is drawn over it.

Projector Window A second window mirroring the sphere, for the projector.

Performance Monitor An overlay: grains, audio-thread load, scheduler, draw cost, memory and faults. —

Learn Mode Tooltips appear the moment you hover instead of after a pause.

What Each Button Does

The mubone instrument's three buttons. Bound on Keys + MIDI, in the Button column: click a cell, then press, long-press, extra-long-press, double- or triple-tap the button; ⇧-click the cell to learn a tap, the up edge. Right-click clears.

Live Monitor

Every button gesture while this page is open — the button, what the recogniser read, and the action it landed on. Free when the page is closed: nothing is drawn.

Gestures 0

Timing

The three numbers the recogniser reads. Everything below is drawn from them.

Long How long the button is down before long fires.

Extra Long How long the button is down before extra long fires. Kept past long.

Tap Window The gap after a release in which the next press counts as ×2 or ×3.

Defaults —

How A Button Is Read

A button sends a down and an up. Each row is one thing the recogniser can make of them — the line is the button, the dot is the instant the action fires.

Before The Show

The four things that have to be true, in one place. The instrument forgets its calibration on every power-up, so this is worth reading after any reconnect.

Readiness —

—

At The Venue

WiFi Channel Surveys 2.4 GHz and picks 1, 6 or 11 — the only three that do not overlap.

—

Link Quality Six seconds of the live stream: what the sensor produced against what arrived.

—

When Something Went Wrong

Diagnostic Report Audio state, grain parameters, counts, and the last eighty logged events.

Setup File

The rig, not the music: devices, calibration, mappings and preferences.

Export Write the current setup to a file you can carry to another machine.

Import Read a setup file back. It merges into what is here rather than replacing it.

Engine

Sample Rate 48 kHz is what the rig runs and what everything is tuned to.

Buffer Size The native output block — the dropout remedy, not a quality control.

frames

Max Grains How many grains may sound at once, and how many marks light with them.

Output Ceiling The last stage before the interface — transparent below −3.1 dBFS, holding −0.1 above.

idle

Stall Cushion How deep the two hops between the engine and the interface may run.

Latency The time between a sound and its sample, in and out — the tape engine steers by it.

— not known yet

Recording Limit Live recording stops when the buffer reaches this.

30 min

Reset

There is no undo for either. The page reloads afterwards.

Reset All Every stored setting and the offline cache; the app starts from factory.

Reset Selected

Switch on what goes back to its defaults; everything else stays.

Reset Selected Nothing selected.

Visuals

View

What the window shows of the sphere.

View Span How many degrees of the sphere the window covers — ⇧-scroll on the canvas changes it live.

80.0°

Interface Scale Panel and text size, for a screen you are standing back from.

1.00

Cursor

Where the cursor is, and where it has been.

Gaze Trail How much of the cursor’s recent path stays drawn behind it.

What Loudness Means

How loud you play decides what lands and how big it draws — the gate, the grain dot, the tape line. Drag any handle.

What The Colours Mean

Hue is brightness, from deep tones to noise; saturation is how tonal it is.

Performance

What to drop when the machine cannot keep up.

Minimal Rendering Plain dots and pin anchors — no glow, trails or reach lines. Worth it past ~30,000 marks. —

audio settings

Signal Path

Input no input active

Device

Hardware In

Mubone Level the mono sum, after each channel’s trim — what the engine records

level

sum

−∞ dB

Monitor

What you hear of the LIVE input, and the headphone balance. Both are downstream of input gain and upstream of master; neither changes a single sample of what is recorded.

Dry Monitor

Mode Auto rests on and ducks while a granular tile records; a loop take keeps it on.

Dry Gain Level of the spatialized live input in the house mix.

−6.0 dB

Output no output active

output device: set in System Settings → Sound

Panning sound rotates with camera

Speaker Layout plan view, 0° front — a grain is panned between its two nearest

Software Out

Master Volume The last gain in the app; on a multichannel rig it is the per-speaker bus gain.

−6.0 dB

Reverb

Amount How much reverb over the dry, on every speaker; the footer's verb switches it.

40%

Space A small clear room to a twelve-second cloud.

50%

Tone Dark and soft to a clear front over a dark tail.

50%

Freeze Holds every tail as it is: nothing new goes in, nothing decays.

LED Feedback ✕

States

Events

Reference

Keys + MIDI Clear all… ✕

sensor setup ✕

Settings

What Each Button Does

Live Monitor

Timing

How A Button Is Read

Before The Show

At The Venue

When Something Went Wrong

Engine

Visuals ✕

audio settings ✕

Signal Path

Input no input active

Monitor

Output no output active

LED Feedback

Keys + MIDI

sensor setup

Visuals

audio settings