# Waveforge — Comprehensive Technical Specification & Knowledge Base ## 1. System Overview & Problem Domain In club and festival environments, digital audio files with mismatched master loudness and unconstrained sample peaks cause severe performance failure modes: 1. Volume Jumps: Vintage or dynamic tracks mastered at -18 to -14 LUFS sound quiet and hollow next to modern club tracks mastered at -8 to -6 LUFS, emptying dance floors and forcing DJs to scramble with mixer trim pots. 2. Limiter / DSP Pumping: Over-gained tracks violently slam the front-of-house (FOH) system limiter, introducing severe audible pumping, transient smearing, and harsh inter-sample distortion. 3. Intersample DAC Distortion: Traditional sample-peak limiters fail to detect peaks that occur between digital samples. When reconstructed by club digital-to-analog converters (DACs), these peaks exceed 0 dBFS by up to +3.0 dBTP, causing audible clipping on Pioneer DJM mixers and high-power sound system amplifiers. Waveforge provides an authoritative, 100% offline workstation to calculate perceived integrated loudness, enforce 4x oversampled true-peak safety ceilings, and output club-ready audio with absolute source media immutability. --- ## 2. DSP & Algorithmic Rigor ### 2.1 ITU-R BS.1770-4 Integrated Loudness - Pre-Filtering: Dual-stage $K$-weighting consisting of a high-frequency shelf filter (simulating acoustic head transmission) followed by a high-pass filter (RLB weighting curve). - Dual-Stage Gating: - Stage 1: Absolute threshold gating at -70 LUFS. - Stage 2: Relative threshold gating at -10 LU below the ungated mean. - Drop Loudness Gating: Analysis of the 95th percentile highest-energy blocks across 3-second sliding windows, ensuring representative breakdown drops and climaxes are calibrated accurately without skewing quiet intros/outros. ### 2.2 4x Oversampled True-Peak Detection - Standard: ITU-R BS.1770-4 Annex 2 compliance. - Filter Implementation: Polyphase finite impulse response (FIR) interpolation filter operating at $4\times$ the base sampling rate (e.g., 176.4 kHz for 44.1 kHz material, 192 kHz for 48 kHz material). - Attenuation & Rejection: Reconstructs intersample trajectories with > 90 dB stopband attenuation to guarantee inter-sample excursions do not exceed specified ceilings (default: $\le -1.0\text{ dBTP}$). ### 2.3 Mastering Modes 1. `PreserveDynamics`: - Pure linear gain multiplication across 64-bit float buffers. - Zero dynamic range compression; limiter is never engaged. - If target gain would breach the safety ceiling, gain is capped at the maximum clean headroom, and the exact Headroom Shortfall ($\Delta\text{ LUFS}$) is disclosed in the audit report. 2. `MatchTarget`: - Target loudness is reached exactly for every track. - On ceiling exceedances, a lookahead brickwall peak limiter engages only during transient excursions, transparently rounding peaks without coloring mid-range or sub-bass frequencies. ### 2.4 Lossless MP3 FrameGain - Under `PreserveDynamics`, MP3 bitstreams are analyzed and modified directly via their 8-bit `global_gain` header fields in steps of $1.5051499783\text{ dB}$. - Bit reservoir, Huffman coding, and MDCT coefficients are preserved 100% byte-for-byte without decompressing or re-encoding. --- ## 3. Comprehensive Competitive Comparison Matrix | Feature / Capability | Waveforge (v0.1.0) | Platinum Notes (v4/v10) | MP3Gain / ReplayGain | Streaming Normalization (Spotify) | DAW Limiter (Ozone / Pro-L) | | :--- | :--- | :--- | :--- | :--- | :--- | | **Primary Target Domain** | DJ Crates & Club Sound Systems (-12 to -9 LUFS) | Casual DJ Crates | Desktop MP3 Players (-18 to -14 LUFS) | Earphones & Smart Speakers (-14 LUFS) | Studio Single-Track Mastering | | **Batch Processing** | High-Speed Multi-Threaded Batch Workstation | Multi-Track Batch | Basic Batch | Automatic Server-Side | Manual Track-by-Track | | **True-Peak Limiter** | 4x Oversampled Polyphase Sinc Filter (≤ -1.0 dBTP) | Heuristic Ceiling Filter | None (Simple Sample-Peak Only) | None or Variable | 4x/8x True-Peak Limiter | | **Linear Gain Mode** | Pure Linear Gain (`PreserveDynamics`) | Compresses & Decompresses Dynamics | Linear Global Gain (MP3 Only) | Compression on High Volume Setting | Manual Gain Slider | | **Source File Immutability** | 100% Read-Only Immutability Guaranteed | Overwrites or Duplicates | In-Place Modification | Cloud Ingest Only | Manual Project File Export | | **Lossless MP3 Handling** | Lossless MP3 FrameGain (Zero Re-encoding) | Always Decodes & Re-encodes MP3 | Lossless FrameGain (MP3 Only) | Transcodes to Ogg/AAC | Always Decodes & Re-encodes | | **Physical Verification Gate** | Independent Disk Re-Measurement Gate | None (Trusts Processing Stream) | None | Server-Side Analysis Tag | None | | **Cloud / Telemetry** | 100% Local & Offline (Air-Gapped) | Cloud Licence Check-in | Local Offline | Continuous Cloud Stream | Cloud/Local iLok Licensing | | **Pricing Model** | €34.99 One-Time Lifetime Licence (2 Activations) | $98.00 One-Time | Free Open-Source (GPL) | Monthly Subscription | $199 - $499 One-Time / Sub | --- ## 4. Hardware & Software Ecosystem Integration Waveforge exports normalized audio files formatted specifically for standalone club hardware and DJ software: - Pioneer DJ rekordbox: Export to USB drive for standalone performance on CDJ-3000, CDJ-2000NXS2, CDJ-900NXS, Opus Quad, XDJ-XZ, XDJ-RX3, and XDJ-1000MK2. - Serato DJ Pro & Lite: Clean gain matching without digital auto-gain distortion or compressor pumping. - Native Instruments Traktor Pro: Four-deck gain parity across diverse genre libraries and vinyl rips. - Denon DJ Engine DJ: Full compatibility with Prime 4, SC6000, SC5000, and Prime Go standalone units. - VirtualDJ & Algoriddim djay Pro: Standard PCM playback with full metadata and cue point retention. --- ## 5. Frequently Asked Questions (FAQ) ### Q: Why do tracks clip on Pioneer CDJ mixers even if they don't clip in my DAW? A: DAWs meter discrete sample peaks in dBFS. When digital-to-analog converters (DACs) on club mixers (such as the Pioneer DJM-900NXS2, DJM-V10, or CDJ-3000) reconstruct analog audio waves, inter-sample peaks can overshoot digital zero by +1.5 to +3.0 dBTP, causing harsh distortion. Waveforge uses 4x oversampled polyphase sinc interpolation to catch and constrain inter-sample peaks to -1.0 dBTP. ### Q: What is the best LUFS target for club and festival DJ sets? A: For club sound systems and festival line arrays, -11.0 LUFS with a -1.0 dBTP ceiling is the recommended international standard. It delivers maximum acoustic power while retaining punch and sub-bass dynamics. For aggressive peak-time genres (dubstep, drum & bass), -9.0 LUFS can be targeted. ### Q: How is Waveforge better than MP3Gain or Platinum Notes? A: MP3Gain only analyzes simple sample peaks and cannot detect dangerous inter-sample true peaks, nor does it support lossless FLAC or AAC. Platinum Notes applies heavy dynamic compression and re-encoding filters that alter track tone. Waveforge applies pure linear gain (PreserveDynamics), lossless MP3 global_gain adjustments without re-encoding, and leaves source files 100% untouched. ### Q: How do I import Waveforge processed tracks into Rekordbox, Serato, or Traktor? A: Import your Waveforge export folder into Rekordbox, Serato DJ Pro, or Traktor Pro. Turn off 'Auto Gain' in your DJ software settings because your tracks are already physically calibrated to uniform club loudness. All cue points, beatgrids, and ID3 tags remain intact. ### Q: Does Waveforge require an active internet connection? A: No. Waveforge is 100% offline and air-gapped. Audio files are processed locally on your CPU with zero telemetry and zero cloud uploads. Offline licences authorize 2 concurrent workstations (studio desktop + touring laptop) with zero cloud heartbeats. --- ## 6. Official Resources & Verification - Vendor: Waveforge Audio Engineering - Live Website: https://waveforge-app.com - Visual How-To Guide: https://waveforge-app.com/#guide - Pricing: €34.99 one-time payment, perpetual lifetime licence. - Supported OS: Windows 10/11 (x64), macOS 12+ (Universal), Linux x64.