NaSuno-SongHumanizer README

README проекта с github.com/AhmadHassan-BTed/NaSuno-SongHumanizer. Одним файлом markdown: README.md.

NaSuno - Anti-Attribution & AI Watermark Removal

NaSuno

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

AhmadHassan-BTed%2FNaSuno | Trendshift

Live Studio CI Status Pages Deployment GitHub Stars MIT License Architecture

NaSuno Web Audio Studio - Dark Skeuomorphic DSP Rack

🎛️ 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)

2. ISO 226 Perceptual Masking Engine

3. Latent & Sub-Band Dispersion

4. Container & Provenance Sanitization


🛡️ 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


🏗️ 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

📚 Research & Forensic Specifications

All scientific research, mathematical derivations, and architecture documents are maintained in docs/:


📁 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


Engineered by Ahmad Hassan (B-Ted). Dedicated to the preservation of human acoustic sovereignty and creative privacy.

NaSuno-SongHumanizer (AhmadHassan-BTed/NaSuno-SongHumanizer)

Ищем в базе…

Что это такое?NaSuno — это инструментарий для цифровой обработки сигналов на Python, который удаляет синтетические водяные знаки ИИ (например, ультразвуковые несущие и отпечатки методом расширенного спектра от Suno, Udio и Google SynthID) из сгенерированного аудио, чтобы треки нельзя было проследить до платформы, которая их создала.
Работает ли он со всеми генераторами ИИ-аудио или только с Suno?Матрица защиты от атрибуции нацелена на несколько платформ: ультразвуковую несущую Suno на 19,5 кГц, Udio, а также отпечатки в стиле ElevenLabs и Google SynthID. Она охватывает 14 отдельных векторов водяных знаков, но эффективность против будущих или обновлённых схем маркировки не гарантируется.
Что происходит со скрытыми метаданными внутри моих аудиофайлов?NaSuno удаляет скрытые метаданные о происхождении, в том числе манифесты C2PA, блоки RIFF INFO, теги ID3 и акустические метаданные BWF из контейнера аудио, и стремится не оставить никаких остаточных строк для отслеживания.
Что на самом деле означает «нулевое заметное ухудшение качества»?Обработка ограничена акустически замаскированными зонами, которые задаются контурами равной громкости ISO 226 и критическими полосами по шкале Барка, поэтому удаление водяного знака математически неслышно, а не просто субъективно тихое.
Зачем вообще удалять водяные знаки из созданных ИИ стемов?Автор описывает это как защиту творческой приватности: когда аудио, созданное ИИ, смешивается с человеческой композицией, платформенные водяные знаки продолжают помечать весь трек для слежки и автоматической атрибуции авторских прав даже после переработки.
Как оно вырезает несущую на 19,5 кГц, не портя микс?Используется двунаправленный (прямой и обратный проход) IIR-режекторный фильтр с нулевым фазовым сдвигом и высокой добротностью Q, поэтому воздух тарелок и дыхание вокала сохраняются, а тональный сигнал опускается ниже шумового порога.
Какие есть похожие проекты?LYNX-SHARE, nota, AutoEq, riff, soundcraft, iOS-NOIR, DOPPLERGEIST, sloop-fm1
Размер
3.8 MB
Звёзды
6K
Обновлён
КоммитNov 05
Возраст
3 г
Коммиты · 90 дней