Skip to content

BustaBitBotScript/Audio-Mastering

 
 

Repository files navigation

Web Audio Mastering

A desktop app for mastering AI-generated music (Suno, Udio, etc.) or any other audio to streaming-ready quality.

Try it in your browser - No installation required!

Source: https://github.com/entrepeneur4lyf/Web-Audio-Mastering

Brought to you by stonedoubt stonedoubt studio studio

Web Audio Mastering

Features

Playback & Analysis

  • FX A/B (On/Off) - Instant before/after comparison, with optional Level Match for fair loudness comparisons
  • Waveform + Scrub - Click-to-seek waveform and scrubber for fast navigation
  • Spectrogram (Live) - Real-time frequency heatmap (great for spotting harsh bands, resonances, and sub build-up while you tweak)
  • Full-chain Metering - Real-time stereo peak metering (FX ON reflects the mastering chain, including the final limiter ceiling)
  • DC Offset Detection - Detects and removes DC offset on load (badge shown when cleanup was applied)

Loudness & Dynamics

  • Input Gain - Adjust input level before processing (-12dB to +12dB)
  • Loudness Normalization - Automatically adjusts to Spotify's -14 LUFS standard
  • Soft Clipper (Pre-Limiter) - Adds punch and headroom when pushing loud masters (common mastering trick)
  • True Peak Limiting - Prevents clipping with adjustable ceiling (-3dB to 0dB)
  • Glue Compression - Light compression to glue the mix together and add punch
  • De-harsh - Hybrid dynamics + dynamic EQ to tame harshness and resonances in AI audio

EQ & Tonal

  • 5-Band Parametric EQ - Fine-tune frequencies (80Hz, 250Hz, 1kHz, 4kHz, 12kHz)
  • EQ Presets - Flat, Vocal Boost, Bass Boost, Bright, Warm, AI Fix
  • Cut Mud - Reduce muddy frequencies around 250Hz
  • Add Air - Sparkle and brightness with 12kHz high shelf boost

Low End

  • Clean Low End - Removes sub-bass rumble below 30Hz

Stereo

  • Stereo Width - Adjustable stereo image (0% mono to 200% extra wide) with real-time preview
  • Mono Bass - Narrows bass below ~200Hz for better club/speaker mono compatibility

Output

  • Output Presets - Quick-switch sample rate/bit depth (48kHz/24-bit recommended)
  • High-Quality WAV Export - Lossless output with all processing applied (master preview matches export)

See DSP-SIGNAL-CHAIN.md for more details on the DSP signal chain.

Download

Get the latest release for your platform:

  • Windows - .exe portable
  • macOS - .dmg disk image
  • Linux - .AppImage

Usage

  1. Drag & drop an audio file (MP3, WAV, FLAC, AAC, M4A)
  2. Preview with the built-in player
  3. Adjust EQ and mastering settings
  4. Toggle FX bypass to compare before/after
  5. Click "Export Mastered WAV"

Building from Source

# Install dependencies
npm install

# Run in development
npm start

# Build web output (for GitHub Pages / static hosting)
npm run build:web

# Preview the production build locally
npm run preview

# Build for your platform
npm run build:win    # Windows
npm run build:mac    # macOS (requires Mac)
npm run build:linux  # Linux

Tech Stack

  • Electron 39
  • Vite 7 (build system)
  • Web Audio API (preview and export processing)
  • Pure JavaScript LUFS measurement (ITU-R BS.1770-4)
  • WaveSurfer.js (waveform visualization)

License

ISC


Acknowledgements

This project is based on Suno-Song-Remaster by SUP3RMASS1VE, licensed under the ISC License.

ISC License

Copyright (c) SUP3RMASS1VE

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

About

Web Audio API Adio Mastering Tools

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 90.6%
  • CSS 5.5%
  • HTML 3.9%