Amphibia

Amphibia 0.1.0 is an independent, free, open-source desktop application and audio plug-in derived from the official open-source Neural Amp Modeler plug-in. It is not the official NAM application and is not affiliated with TONE3000.

The repository has completed the implementation scope of Milestones 0 through 8. Product identity and side-by-side identifiers are established, model and impulse-response preparation runs outside the audio thread, Amphibia includes an optional local managed library, and the Windows standalone has a native first-run/audio/content setup wizard. The VST3 has an explicit configuration panel while leaving audio ownership to the DAW. TONE3000 hosted selection remains behind a fail-closed registration gate. Milestone 8 validates a clean unsigned Windows x64 package and its release evidence, but concludes that public release is blocked.

Current scope

• Standalone application and VST3 product targets named Amphibia.
• Windows first-run setup with transactional audio changes, bounded output test, input meter, local-folder choices, library health/actions, summary, repair/rerun, safe mode, and versioned atomic settings.
• Explicit VST3 Configuration panel for shared local folders, library/provider status, and the required DAW-owned-audio boundary; it never launches the standalone wizard.
• Existing referenced .nam model and WAV impulse-response workflow inherited from upstream.
• Background model/IR inspection and preparation with bounded audio-boundary activation.
• Optional content-addressed managed library with streamed SHA-256 deduplication, transactional metadata, verification, cleanup, and recovery.
• Local individual-file, recursive-folder, multi-file drag/drop, and reviewed ZIP-pack importing.
• Reader-only ZIP handling with traversal, link, collision, encryption, compression-ratio, count, size, CRC, and disk-space defenses.
• Backward-compatible state 1.1 managed-object references while retaining Amphibia 1.0 and legacy NAM readers.
• Provider-neutral remote-content interfaces, external-browser OAuth PKCE, Windows Credential Manager/macOS Keychain source support, and bounded TONE3000 API/download foundations.
• Streamed explicit individual-model promotion through the existing managed-library SHA-256, inspection, deduplication, and provenance boundary; no automatic activation.
• Visible Search TONE3000 and Find IR on TONE3000 entries, a native bounded exact-variant/attribution panel, and explicit Download Only versus Download and Audition semantics. In the repository build these entries are disabled and perform no provider work because production registration is unavailable.
• New VST3, AU, Windows project, installer, bundle, and data identifiers.
• Windows x64 component installer, portable archives, provenance/dependency manifests, checksums, optional Authenticode hooks, and packaging CI.

Windows standalone/VST3 compilation and the Milestone 2–8 automated suites pass. The final 51-component CycloneDX SBOM independently validates, exact compiled-asset evidence is generated, and complementary source/artifact secret scans report no findings. Setup audio-device tests are fake-based; no real audio hardware or DAW-host manual pass is claimed. Provider validation uses deterministic mocks and a loopback-only local test server; no live TONE3000 authorization or download is claimed. Clean-VM install/upgrade/uninstall, side-by-side NAM, signing, complete vulnerability review, inherited UI-art and ASIO authority, macOS, and physical-host validation remain release gates. The two embedded fonts are individually cleared; that does not clear the inherited UI artwork.

Build from source

Clone recursively, then follow BUILDING.md. The short form is:

git clone --recursive https://github.com/atoontoto/Amphibia.git
cd amphibia

Windows builds use NeuralAmpModeler/Amphibia.sln; the retained source directory and many internal filenames deliberately match upstream to reduce future merge conflicts. See CONTRIBUTING.md for validation commands.

Project records

• Architecture plan
• Milestone checklist
• Identifier registry
• Milestone 1 report
• Milestone 2 DSP loading map
• Milestone 3 final report
• Milestone 4 TONE3000 foundation report
• Milestone 5 hosted-selection report
• First-run setup and audio configuration
• Settings ownership and settings schema
• Milestone 6 setup report
• Milestone 7 Windows deployment report
• Milestone 8 validation report, candidate notes, and release checklist
• Windows installation, packaging, and release gates
• TONE3000 integration boundary
• Local library guide
• Secure ZIP import policy
• Attribution and third-party notices
• Privacy and security

License

The inherited code and Amphibia modifications are provided under the repository MIT license, subject to the separate licenses and notices of included dependencies. Do not assume that every inherited visual asset or SDK interface is cleared for redistribution; see ATTRIBUTION.md and the Windows license review.