analyze_audio
Read-onlyIdempotent
Measure loudness, true peak, stereo phase, and band balance on any track to verify mix consistency and catch phase or level issues.
Instructions
Measure the audio itself: loudness, true peak, stereo phase and band balance.
Reads the LiveMaestro Analyzer Max for Live device over loopback OSC. This
is the only tool that needs that device. Without it every other tool works and
this one reports device_not_found with the steps to load it.
What comes back, and what each figure is:
- Loudness to EBU R128, from Max's loudness~: momentary (400 ms), short term
(3 s), gated integrated since the last reset, and loudness range.
- True peak, oversampled, so peaks between two samples count. Sample peak and
RMS beside it, and the crest factor between peak and RMS.
- Stereo correlation over the whole band and below 120 Hz, and whether the low
end survives being summed to mono.
- Energy in seven bands on the mono sum, plus their energy weighted centre.
That centre is a centre of mass over seven band levels, not an FFT centroid.
Where it measures matters. The device reads the signal at its own position in
the chain, so it belongs last on the track: an effect loaded after it is not
in what it reports. A master track's device chain sits before the master
fader, so a master reading matches the set's output only while that fader is
at 0.0 dB.
The two peak figures are maxima since the meter was last reset and only rise.
To measure a peak, call once with reset=true, let at least one pass of the
material through, then call again. The averaged figures need no reset.
A read-back proves the stored value and never audibility: this proves what the
signal measured as it passed the device, which is a different and stronger
claim than any parameter value, and still not a claim about the room.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reset | No | Restart the integrated loudness and loudness range before measuring, to integrate one section rather than everything since the audio engine started. The reply that performs the reset reports no integrated figure, because it had just begun. | |
| track | No | Which analyzer to read: a track name, a zero-based track index, 'master' for the main track, or '*' for whichever instance answers first. Every instance in the set answers every request, and the result lists them all under 'answered'. An index or 'master' costs one extra round trip, because the device reports the name of its track and the index is resolved against the set here. | master |
| window_ms | No | How far back the averaged measurements reach, in milliseconds. This governs the averaged figures alone: RMS, both correlations and the seven bands. Loudness keeps its own EBU windows and the peaks are maxima since the last reset. This looks backwards at audio that already played and returns immediately. It does not record for this long. The device buffers a fixed number of samples, so the window this reaches depends on the sample rate: about 2180 ms at 44.1 kHz and 1000 ms at 96 kHz. A longer request is clamped without complaint, so read window_ms back off the result rather than assuming the request was honoured. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||