Skip to content

v0.4.2 — hot captures no longer fail with "Output clipped."

Choose a tag to compare

@github-actions github-actions released this 01 Aug 12:47

One bug fix, and it's the one that made some captures refuse to convert at all.

"ValueError: Output clipped."

If a conversion died with ValueError: Output clipped. while other files went through fine, this release fixes it. Nothing was wrong with your .nam — it was just a loud one.

Here's what was happening. The converter works by rendering a DI through your A2 capture, then training an A1 to match that render. Neural Amp Modeler refuses to train on a target that reaches digital full scale, and it's strict about it: one single sample at the rail rejects the whole file. A hot capture — high-gain amp, a boost or drive in front — renders louder than full scale, and the converter was writing that render out unchanged. The 24-bit file pins anything at or below -1.0 to exactly -1.0, NAM sees the rail, and the run stops before training ever starts.

That's why it looked random. Quieter captures never hit the rail; anything with real gain in it did. It also only ever triggered on the negative half of the waveform, which is why two similar-looking captures could behave differently.

The converter now turns the render down before writing it, and puts the level back on the finished model afterwards. That last part matters: the output level is a single number in a .nam file, so restoring it is an exact edit, not a re-training and not an approximation. Your A1 comes out at the same volume as the A2 it came from, same as always.

Captures that already converted are unaffected — they were never near the rail, so nothing is turned down and nothing is put back. There's no reason to re-convert anything that already worked.

Thanks to the person on reddit who reported it. "Some files work, some don't" was the detail that made it findable.

Downloads

Platform File
macOS (signed + notarized) nam-a2a1-converter-macos.dmg
Windows nam-a2a1-converter-windows.zip
Windows + NVIDIA nam-a2a1-converter-windows-cuda.zip.001 and .002
Linux x86_64 nam-a2a1-converter-linux-x86_64.tar.gz
Linux x86_64 + NVIDIA nam-a2a1-converter-linux-x86_64-cuda.tar.gz.001, .002 and .003

The CUDA bundles ship as numbered parts because GitHub caps one release file at 2 GiB. Rejoin them the same way as last release:

cat nam-a2a1-converter-linux-x86_64-cuda.tar.gz.0* > nam-a2a1-converter-linux-x86_64-cuda.tar.gz
sha256sum -c --ignore-missing nam-a2a1-converter-linux-x86_64-cuda.tar.gz.sha256
tar -xzf nam-a2a1-converter-linux-x86_64-cuda.tar.gz

Windows: download get-cuda-build.ps1 and run powershell -ExecutionPolicy Bypass -File get-cuda-build.ps1, or copy /b the two parts together by hand. Full detail is in the v0.4.0 notes.

Requires an NVIDIA card of compute capability 5.0+ with a current driver. Apple silicon uses its GPU automatically — nothing to download. Signing is unchanged: macOS is signed + notarized, Windows is unsigned so SmartScreen warns — More info → Run anyway.