FAQ

How do I install the registry release? Each command installs the latest published version of its package.

Python package

pip install effetune

JavaScript package

npm install @effetune/dsp

These docs describe v0.5.0. Pin that exact version when reproducibility matters, for example pip install effetune==0.5.0 or npm install @effetune/dsp@0.5.0.

Why does my Python array fail? Use finite C-contiguous planar float32 shaped (channels, frames).

Why was JavaScript audio rejected? Every Float32Array sample must be finite. NaN and positive or negative infinity are rejected before native processing, so a bad stream block can be fixed and retried without resetting the stream.

Why does Worklet loading fail? Use HTTPS/localhost and verify same-origin URLs, MIME types, CSP, processor/WASM/meta files, and a resumed AudioContext. Direct file: loading is unsupported.

Does the library decode, encode, resample, call ffmpeg, or measure loudness? No. Those are caller responsibilities in v0.1.

Why do offline and streaming output differ? Offline starts fresh. Streams retain history and require the same block/event schedule for reproduction.

Why is an IR rejected? Check resolver output, SHA-256, byte length, ETA1 topology, rate, channel mapping, and the 32 MiB cap.

Errors

ValidationError covers document/parameter failures, EffectError unknown effects, AssetError resolver/asset failures, runtime errors backend failures, and state errors invalid lifecycle operations. Show users a plain-language cause and next action; send technical diagnostics to the developer console.