AhmadHassan-BTed/NaSuno
ahmadhassan-bted.github.io/NaSuno/AI audio watermark removal & forensic anti-attribution toolkit. Neutralizes Suno, Udio, and neural fingerprints with ISO 226 perceptual masking.
ο»Ώ
NaSuno
Defensive Psychoacoustic Audio DSP Toolkit & Forensic Anti-Attribution Engine
Surgically neutralize Suno, Udio, and synthetic audio watermarks with zero perceptible quality degradation.
ποΈ Launch Web Audio Studio β’ Capability Matrix β’ 14-Vector Defense β’ Architecture β’ Research Specs β’ Governance
β‘ Executive Summary
Generative audio models (Suno, Udio, ElevenLabs, Google SynthID) inject proprietary synthetic watermarks, high-frequency ultrasonic carriers (19.5 kHz), phase-locked spread spectrums, and latent provenance tags into generated waveforms. When musicians, producers, or sound designers incorporate AI stems, sound effects, or background textures into human compositions, their entire track becomes forensically tagged for platform surveillance and automated copyright attribution.
NaSuno is a defensive, mathematical signal processing framework designed to decouple human musical creativity from synthetic platform tracking. Built on ISO 226 equal-loudness contours, Bark-scale critical-band psychoacoustics, and zero-phase IIR notch filtering, NaSuno strips forensic tracking markers while maintaining complete spectral transparency, transient punch, and stereo correlation.
π Core Capabilities & Product Matrix
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β NASUNO CORE CAPABILITIES β
βββββββββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββ¬βββββββββ€
β π¨ Watermark & Carrier Purge β Psychoacoustic Masking β Forensic Anti-Attribution β WAV β
β - Ultrasonic Notch (19.5kHz) β - ISO 226 Equal Loudness β - Suno AI Carrier Excision β - FLACβ
β - SynthID Inaudible Spread β - Bark-Scale Masking Latency β - Udio Latent Neutralization β - MP3 β
β - Zero-Phase Bi-Directional β - TPDF Dither Reconstruction β - C2PA / RIFF Tag Stripping β - OGG β
βββββββββββββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββ΄βββββββββ
1. Ultrasonic Carrier Notch Filtering (19.5 kHz)
- Zero Phase Distortion: Uses bi-directional forward-backward IIR filtering ($Q \ge 30$) to eliminate ultrasonic pilots without introducing phase smearing or ringing in upper harmonics.
- Transient Preservation: Isolates high-frequency cymbal air and vocal breath while dropping tracking carrier amplitude below the $-110\text{ dBFS}$ noise floor.
2. ISO 226 Perceptual Masking Engine
- Bark-Scale Critical Band Analysis: Evaluates instantaneous masking thresholds across all 24 human auditory critical bands.
- Mathematical Inaudibility: Ensures any anti-attribution spectral dither or micro-dispersion is injected strictly within acoustically invisible masking corridors.
3. Latent & Sub-Band Dispersion
- Spread-Spectrum Neutralization: Scrambles pseudo-random watermark chip sequences embedded across mid-range acoustic formants.
- Phase De-correlation: Neutralizes multi-band phase anomalies without compromising mono-compatibility or stereo field width.
4. Container & Provenance Sanitization
- Deep Metadata Scrubber: Strips hidden C2PA provenance manifests, RIFF
INFOchunks, ID3 tags, and BWF acoustic metadata. - Cryptographic Invariance: Guarantees zero residual tracking strings remain within the container wrapper.
π‘οΈ 14-Vector Anti-Attribution Matrix
| Vector ID | Target Artifact / Platform | Forensic Carrier Mechanism | DSP Countermeasure | Impact on Audio | Evasion Status |
|---|---|---|---|---|---|
| V-01 | Suno AI Ultrasonic Carrier | 19.5 kHz continuous sinusoids | Zero-Phase IIR Notch ($Q=35$) | Transparent ($\Delta < 0.02\text{ dB}$) | β Neutralized |
| V-02 | Udio Diffusion Harmonics | Phase-locked periodic micro-artifacts | Formant-Aware Dynamic Phase Shift | Transparent | β Neutralized |
| V-03 | Google SynthID Audio | Inaudible spread-spectrum chip sequences | Perceptual Bark-Band De-correlation | Inaudible | β Neutralized |
| V-04 | C2PA & Provenance Manifests | Metadata headers & file chunk payloads | Bitstream Structural Excision | Zero impact on audio | β Sanitized |
| V-05 | Neural Vocoder Latent Peaks | Fixed comb peaks from HiFi-GAN / EnCodec | Adaptive Spectral Smoother | Natural harmonic tone | β Smoothed |
| V-06 | Micro-Timing Lattice | Rigid grid quantized sample placement | Humanized Gaussian Micro-Jitter | Enhanced natural groove | β Humanized |
| V-07 | Sub-Bass Infrasonic Pilot | $5\text{--}18\text{ Hz}$ phase-offset tracking tones | 24 dB/Oct Butterworth High-Pass ($20\text{ Hz}$) | Cleans subwoofer headroom | β Removed |
| V-08 | Quantization Footprints | Deterministic truncations | TPDF Psychoacoustic Dithering | Lowers perceived noise | β Dithered |
| V-09 | Stereo Phase Correlation | Artificial spatial coherence vectors | Micro-Stereo Blumlein Decorrelator | Preserves monocompatibility | β Decorrelated |
| V-10 | Dynamic Range Invariance | Flat compression curves of AI models | Non-Linear Transient Expander | Restores punch & dynamics | β Restored |
| V-11 | RIFF/ID3 Injected Chunks | AI watermarks in padding bytes | Zero-Byte Re-alignment | Bit-perfect header rewrite | β Sanitized |
| V-12 | Harmonic Comb Artifacts | Pitch-synchronous overtone fingerprints | Multi-Band Comb Anti-Filter | Warm analog resonance | β Neutralized |
| V-13 | Spectral Flux Regularity | Unnatural constant flux across frames | Controlled Entropic Modulation | Analog console warmth | β Modulated |
| V-14 | Bit-Depth Statistical Fingerprint | Identical bit patterns across quiet stems | Sub-Audible Stochastic Whitening | Meets broadcast standards | β Randomized |
ποΈ Live Web Audio DSP Studio
Test and experience NaSuno directly in your browser with zero installation:
π Launch NaSuno Web Audio Studio
- 100% Client-Side: Processes audio strictly in memory using the Web Audio API. Zero files uploaded, zero data logged.
- FL Studio-Inspired Interface: Dark skeuomorphic DSP rack featuring realistic aluminum rotary knobs, LED VU meters, and interactive frequency analyzers.
- Real-Time Visual Diagnostics: Live 2048-point FFT spectrum analyzer and stereo phase oscilloscope.
- Parametric Humanization Dial: Continuously adjust from
0% (Raw AI Signal)to100% (Fully Humanized Master).
ποΈ System Architecture
NaSuno is architected according to strict Hexagonal Architecture principles, segregating public documentation, research, and client interfaces from the high-throughput core engine.
graph TD
subgraph PublicWrapper ["Public Interface & Specification (This Repository)"]
UI["Web Audio DSP Studio (docs/index.html)"]
SPECS["14-Vector Forensic Taxonomy (docs/research/)"]
ARCH["Hexagonal Architectural Rules (docs/architecture.md)"]
end
subgraph CoreEngine ["Private Core Engine (NaSuno-core)"]
DSP["Zero-Phase DSP Pipeline (C++ / Python)"]
PSYCHO["ISO 226 Perceptual Masking Kernel"]
TESTS["72-Test Forensic Verification Suite"]
end
UI -->|Evaluates Algorithms| SPECS
SPECS -->|Formal Constraints| ARCH
ARCH -.->|Implements Architecture| CoreEngine
DSP --> PSYCHO
- Public Wrapper (
NaSuno): Hosts the live browser-based Web Audio DSP studio, mathematical research papers, forensic specifications, and architecture rules. - Private Engine (
NaSuno-core): Contains the high-throughput C++/Python DSP pipeline, automated batch processing CLI, and the 72-test forensic validation test suite.
π Research & Forensic Specifications
All scientific research, mathematical derivations, and architecture documents are maintained in docs/:
- System Architecture Document β Hexagonal ports and adapters, audio buffer contracts, and latency budgets.
- Forensic Watermark Taxonomy β Exhaustive analysis of Suno, Udio, and SynthID watermark vectors.
- Psychoacoustics & Masking Reference β ISO 226 equal-loudness math and Bark-band calculations.
- Master Evasion Strategy β Mathematical guarantees and differential audio test methodologies.
- API Reference β Programmatic DSP contracts and parameters.
- Development Roadmap β VST3/AU plugin targets and hardware DSP port plans.
π Repository Structure
NaSuno/
βββ .github/
β βββ workflows/
β β βββ ci.yml # Documentation & JSON registry verification
β β βββ pages.yml # Automated GitHub Pages web studio deployment
β βββ ISSUE_TEMPLATE/ # Bug reports and feature request templates
β βββ CODE_OF_CONDUCT.md # Contributor Covenant standard
β βββ CONTRIBUTING.md # Open-source contribution guidelines
β βββ SECURITY.md # Vulnerability reporting protocol
β βββ SUPPORT.md # Developer contact & community channels
βββ docs/
β βββ assets/ # Banners, logos, and UI imagery
β βββ audio/ # Uncompressed before/after reference stems
β βββ modules/ # Web Audio DSP pipeline modules
β βββ research/ # Mathematical & forensic research documents
β βββ architecture.md # Formal engineering architecture specification
β βββ index.html # Live Web Audio DSP Studio application
β βββ knob-registry.json # Parameter definitions and DSP coefficients
β βββ style.css # Dark skeuomorphic rack stylesheet
β βββ sitemap.xml # SEO discovery map
βββ CHANGELOG.md # Semantic version release notes
βββ LICENSE # MIT Open Source License
βββ README.md # Core project documentation
π€ Community & Governance
- Direct Developer Contact: ahmadhassan.bted@gmail.com
- Bug Reports & Inquiries: Open an Issue
- Security Advisories: Review our Security Policy for responsible disclosure procedures.
- Code of Conduct: Please review our Code of Conduct.
Engineered by Ahmad Hassan (B-Ted). Dedicated to the preservation of human acoustic sovereignty and creative privacy.