HiRes-Auditor

A high-throughput, multithreaded Digital Signal Processing (DSP) CLI utility for Linux designed to audit digital audio libraries. HiRes-Auditor automatically detects fake and upscaled Hi-Res audio tracks (e.g., standard CD-quality 44.1/48 kHz audio upscaled into 96/192 kHz or DSD containers) by analyzing high-frequency acoustic energy distributions above 21 kHz.

The Problem

A common issue in lossless audio distribution is "upscaling"—taking a standard 16-bit / 44.1 kHz master, resampling it to 24-bit / 96 kHz or 192 kHz, and marketing it as genuine studio Hi-Res. While the file metadata reflects high bit rates, the acoustic spectrum cuts off sharply at the Nyquist frequency of the original recording (~20–22 kHz).

How It Works

1. Stream Demuxing & Normalization: Utilizes ffmpeg and ffprobe to demux containers and stream native PCM signals across standard and 1-bit bitstreams.
2. Bandpass Filtering: Passes audio through a steep sinc high-pass filter isolated strictly above 21 kHz using sox.
3. Spectral Power Verification: Computes the peak RMS energy across the filtered band. Files showing only digital dither noise or empty spectrum (RMS peak < -50 dBFS) are flagged as upscaled.
4. Multicore Parallelization: Utilizes POSIX thread pools via xargs across all available hardware cores (nproc) to audit massive multi-terabyte libraries quickly.

Features

• Broad Codec Support: FLAC, WAV, DSF, DSD, DFF.
• Auto Dependency Resolution: Automatic package detection and installation across pacman, apt, dnf, and zypper.
• Zero Configuration: Single-command execution with smart default fallback to the user environment.
• Structured Audit Report: Produces a clean, tabular summary of sample rates, bit depths, dynamic ranges, and verification status.

Quick Start (One-Liner)

Run directly via curl without cloning:

bash <(curl -sSL [https://raw.githubusercontent.com/iMoloy/HiRes-Auditor/main/scan_hires.sh](https://raw.githubusercontent.com/iMoloy/HiRes-Auditor/main/scan_hires.sh)) /path/to/music