██████╗  ██████╗ ██╗     ███████╗███████╗
      ██╔══██╗██╔═══██╗██║     ██╔════╝╚══███╔╝
      ██████╔╝██║   ██║██║     █████╗    ███╔╝
      ██╔═══╝ ██║   ██║██║     ██╔══╝   ███╔╝
      ██║     ╚██████╔╝███████╗███████╗███████╗
      ╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝

    ─╴╶─╴╶─▁▂▃▄▅▆▇█▇▆▅▄▃▂▁─╴╶─▁▂▃▅▇█▇▅▃▂▁─╴╶─╴╶─

    Audio Forensics & Sanitization Engine    v2.0

    ─╴╶─╴╶─▁▂▃▅▇█▇▅▃▂▁─╴╶─▁▂▃▄▅▆▇█▇▆▅▄▃▂▁─╴╶─╴╶─

Audio forensics and sanitization engine. Analyzes, detects, and removes watermarks, metadata, and statistical fingerprints from audio files.

Install

Requires Rust 1.70+.

cargo build --release

Binary outputs to target/release/polez (or polez.exe on Windows).

Commands

clean

Sanitize a single audio file.

polez clean input.mp3 -o clean.mp3
polez clean input.wav --paranoid --verify
polez clean input.mp3 --backup --format wav

Flag	Description
-o, --output	Output file path (auto-generated if omitted)
--paranoid	Multi-pass aggressive cleaning
--verify	Re-analyze output and report removal effectiveness
--backup	Create backup of original
-f, --format	Output format: preserve, mp3, wav

sweep

Batch process a directory of audio files.

polez sweep ./music/
polez sweep ./music/ -d ./clean/ --paranoid --workers 8
polez sweep ./music/ -r --extension mp3 wav flac
polez sweep ./music/ --dry-run

Flag	Description
-d, --output-dir	Output directory
-e, --extension	File extensions to process (default: mp3, wav)
--paranoid	Multi-pass aggressive cleaning
-w, --workers	Parallel worker count (default: 4)
-r, --recursive	Process subdirectories
--dry-run	List files without processing
--backup	Create backups

detect

Detect watermarks and fingerprints without modifying the file.

polez detect input.mp3
polez detect input.wav --deep

Flag	Description
--deep	Enable statistical analysis with AI probability scoring

inspect

Visualize high-frequency spectrogram to reveal watermarks.

polez inspect input.mp3 --freq-min 15000 --freq-max 24000
polez inspect input.wav --start 10 --duration 5

bits

View raw bit patterns to find embedded watermark data.

polez bits input.mp3 --bit 0 --count 10000
polez bits input.wav --search

benchmark

Batch scan a directory and output CSV results for dataset analysis.

polez benchmark ./dataset/ -o results.csv -r

gui

Launch web-based forensics GUI (requires gui feature).

cargo build --release --features gui
polez gui --port 3000

config

Manage presets and configuration.

polez config list
polez config show
polez config preset stealth-plus
polez config create my-preset --paranoid high --quality maximum
polez config delete my-preset
polez config reset

Built-in presets: stealth, stealth-plus, fast, quality, research.

Advanced Stealth Flags

Fine-grained control over individual sanitization operations (used with clean):

Flag	Default	Description
--phase-dither	on	Sub-block phase dither
--comb-mask	on	Dynamic comb masking
--transient-shift	on	Transient micro-shift
--resample-nudge	on	Resample nudge
--phase-noise	on	FFT phase noise
--phase-swirl	on	Phase swirl (allpass cascade)
--masked-hf-phase	off	Masked high-frequency phase noise
--gated-resample-nudge	off	RMS-gated resample nudge
--micro-eq-flutter	off	Micro-EQ flutter modulation
--hf-decorrelate	off	HF band decorrelation
--refined-transient	off	Refined transient micro-shift
--adaptive-transient	off	Adaptive onset-strength transient shift

Detection Methods

Polez uses 6 watermark detection algorithms:

• Spread spectrum — STFT high-frequency consistency analysis
• Echo signatures — Autocorrelation peak detection (1–50ms delays)
• Statistical anomalies — Entropy, kurtosis, and spectral entropy checks
• Phase modulation — STFT phase unwrapping consistency
• Amplitude modulation — Hilbert envelope FFT peak analysis
• Frequency domain — Spectral flatness and peak consistency

Sanitization Pipeline

Four modes with increasing aggressiveness:

Mode	What it does
Fast	Metadata stripping only
Standard	Spectral cleaning + fingerprint removal
Preserving	Standard + 20 stealth DSP operations
Aggressive	All operations with paranoid parameters

The --paranoid flag forces Aggressive mode with 2 additional passes.

Supported Formats

Format	Read	Write
WAV	Yes	Yes
MP3	Yes	Yes

Documentation

• Algorithm Reference — detection methods, stealth operations, and parameter details
• Configuration Guide — config file format, presets, and environment variables
• Troubleshooting & FAQ — common issues and solutions

License

MIT