NaSuno

Defensive Psychoacoustic Audio DSP Toolkit & Forensic Anti-Attribution Engine
Surgically neutralize Suno, Udio, and synthetic audio watermarks with zero perceptible quality degradation.

Conceived, Architected, and Authored by Ahmad Hassan (B-Ted)

🎛️ 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 INFO chunks, 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) to 100% (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.}