Audio mastering tool

Purpose & User Intent: This tool provides an end-to-end online mastering workflow for music producers, indie artists, and post-audio studios. It solves inconsistencies in loudness and tonal balance across releases by offering a repeatable processing chain. Typical use cases include pre-mastering for streaming platforms, quick checks on rough mixes, and offline mastering when a DAW is unavailable.
Core Logic & Features: The tool performs LUFS-based loudness measurement using ITU-R BS.1770 standards, applies a configurable mastering chain (EQ, compression, limiting, and optional stereo widening), and exports a finalized stereo master. Required features include audio upload, integrated LUFS target, true-peak monitoring, dithering, and a downloadable master. Optional features include reference-track matching, batch processing, multiple output formats, and audit-ready metrics.
Inputs & Outputs: Inputs include input_audio (file), target_lufs (LUFS, numeric), target_true_peak (dBTP, optional), sample_rate (kHz, optional), dithering (boolean, optional), and reference_track (file, optional). Outputs include mastered_audio (audio file), metrics_report (JSON), and a summary_log (text).
Algorithms & Calculations: It uses ITU-R BS.1770 integrated LUFS for loudness, applies gain changes to meet target, then passes through a mastering chain with optional limiter to avoid clipping. Dither is added at export if requested and peak limiting is configured.
Error & Edge Cases: Unsupported formats, corrupted inputs, or missing mandatory inputs produce structured error codes. Extremely low sample rates, extreme peak levels, or incompatible target values trigger safe defaults or fallback processing. When a reference track is provided, mismatched length or sample rate may degrade alignment.
Industry/Region & Localization: Aligns with ITU-R BS.1770 and EBU R128 conventions; designed for streaming platforms with LUFS and true-peak requirements. Locale is en-US; supports multiple regions via configurable unit strings.
Assumptions & Exclusions: Assumes stereo input; not a full DAW replacement; does not guarantee artistic decisions or multitrack mastering; exports are subject to input quality and platform-specific constraints.