konradre/video-production-skills / skills/mastering-audio
mastering-audio
VerifiedMaster audio files (especially Suno/Udio AI music) for streaming release with LUFS normalization, true peak limiting, and optional enhancements. Triggers — "master this", "master the track", "LUFS normalize", "optimize for streaming". Not for a spot's or film's delivery loudness — use video-finish-qc.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.4 KB |
| lib/dsp/constants.js | script | 1.8 KB |
| lib/dsp/dc-offset.js | script | 4.2 KB |
| lib/dsp/dynamic-leveler.js | script | 10.6 KB |
| lib/dsp/dynamic-processor.js | script | 16.8 KB |
| lib/dsp/exciter.js | script | 7.9 KB |
| lib/dsp/fft.js | script | 6.5 KB |
| lib/dsp/final-filters.js | script | 3.2 KB |
| lib/dsp/index.js | script | 3.2 KB |
| lib/dsp/limiter.js | script | 12.2 KB |
| lib/dsp/lufs.js | script | 5.7 KB |
| lib/dsp/multiband-saturation.js | script | 13.3 KB |
| lib/dsp/multiband-transient.js | script | 8.1 KB |
| lib/dsp/multiband.js | script | 8.2 KB |
| lib/dsp/normalizer.js | script | 4.5 KB |
| lib/dsp/saturation.js | script | 9.3 KB |
| lib/dsp/soft-clipper.js | script | 9.1 KB |
| lib/dsp/stereo.js | script | 8.8 KB |
| lib/dsp/transient.js | script | 7.9 KB |
| lib/dsp/true-peak.js | script | 2.6 KB |
| lib/dsp/utils.js | script | 4.4 KB |
| lib/src/audio-buffer-shim.js | script | 3.6 KB |
| lib/src/wav-encoder.js | script | 5.1 KB |
| package-lock.json | manifest | 611 B |
| package.json | manifest | 187 B |
| scripts/master.mjs | script | 15.2 KB |
lib/dsp/soft-clipper.js
View on GitHub/**
* Soft Clipper
* Gentle peak shaving using saturation curves
*
* Designed to reduce peak-to-loudness ratio before limiting,
* allowing louder masters without heavy limiter pumping.
*/
import { dbToLinear, linearToDb, interpolateCatmullRom } from './utils.js';
/**
* Soft clipper defaults
*/
export const SOFT_CLIPPER_DEFAULTS = {
threshold: -6, // dB - start clipping above this
ceiling: -0.5, // dB - absolute maximum output
knee: 3, // dB - soft knee width
drive: 1.5, // Saturation intensity (1.0 = gentle, 2.0 = aggressive)
mix: 1.0 // Wet/dry mix (1.0 = full wet)
};
/**
* Soft clipping curve using tanh saturation
* @param {number} sample - Input sample
* @param {number} threshold - Threshold in linear
* @param {number} ceiling - Ceiling in linear
* @param {number} drive - Drive amount
* @param {number} knee - Knee width in linear ratio
* @returns {number} Clipped sample
*/
function softClipSample(sample, threshold, ceiling, drive, knee) {
const sign = Math.sign(sample);
const abs = Math.abs(sample);
if (abs <= threshold) {
// Below threshold - pass through
return sample;
}
// Calculate how far above threshold
const excess = abs - threshold;
const range = ceiling - threshold;
if (range <= 0) {
// Edge case - ceiling at or below threshold
return sign * Math.min(abs, ceiling);
}
// Normalize excess to 0-1+ range
const normalized = excess / range;
// Apply tanh saturation with drive
// tanh approaches 1 asymptotically, so output approaches ceiling
const saturated = Math.tanh(normalized * drive);
// Map back to threshold-ceiling range
const output = threshold + saturated * range;
return sign * Math.min(output, ceiling);
}
/**
* Apply soft clipping to an AudioBuffer
* @param {AudioBuffer} buffer - Input audio buffer
* @param {Object} options - Clipper options
* @param {Function} onProgress - Progress callback (0-1)
* @returns {AudioBuffer} Clipped audio buffer
*/
export function applySoftClip(buffer, options = {}, onProgress = null) {
const {
threshold = SOFT_CLIPPER_DEFAULTS.threshold,
ceiling = SOFT_CLIPPER_DEFAULTS.ceiling,
knee = SOFT_CLIPPER_DEFAULTS.knee,
drive = SOFT_CLIPPER_DEFAULTS.drive,
mix = SOFT_CLIPPER_DEFAULTS.mix
} = options;
const thresholdLin = dbToLinear(threshold);
const ceilingLin = dbToLinear(ceiling);
const kneeLin = dbToLinear(knee) - 1; // Convert dB knee to ratio
const numChannels = buffer.numberOfChannels;
const length = buffer.length;
// Create output buffer
const outputBuffer = new AudioBuffer({
numberOfChannels: numChannels,
length: length,
sampleRate: buffer.sampleRate
});
// Track clipping statistics
let peakReduction = 0;
let samplesClipped = 0;
for (let ch = 0; ch < numChannels; ch++) {
const input = buffer.getChannelData(ch);
const output = outputBuffer.getChannelData(ch);
for (let i = 0; i < length; i++) {
const sample = input[i];
const clipped = softClipSample(sample, thresholdLin, ceilingLin, drive, kneeLin);
// Apply wet/dry mix
output[i] = mix < 1 ? sample * (1 - mix) + clipped * mix : clipped;
// Track stats
if (Math.abs(clipped) < Math.abs(sample)) {
samplesClipped++;
peakReduction = Math.max(peakReduction, Math.abs(sample) - Math.abs(clipped));
}
}
if (onProgress) {
onProgress((ch + 1) / numChannels);
}
}
const clippedPercent = (samplesClipped / (length * numChannels) * 100).toFixed(2);
const reductionDb = peakReduction > 0 ? linearToDb(1 + peakReduction).toFixed(1) : '0.0';
console.log(`[Soft Clipper] ${clippedPercent}% samples clipped, max reduction: ${reductionDb} dB`);
return outputBuffer;
}
/**
* Two-stage soft clipper for more transparent results
* Stage 1: Gentle clip at higher threshold
* Stage 2: Firmer clip closer to ceiling
*
* @param {AudioBuffer} buffer - Input audio buffer
* @param {number} ceiling - Final ceiling in dB
* @param {Function} onProgress - Progress callback
* @returns {AudioBuffer} Clipped audio buffer
*/
export function applyTwoStageSoftClip(buffer, ceiling = -1, onProgress = null) {
// Stage 1: Gentle clipping starting 6dB above ceiling
let result = applySoftClip(buffer, {
threshold: ceiling + 6, // -7 dB if ceiling is -1
ceiling: ceiling + 2, // -3 dB if ceiling is -1
drive: 1.2,
mix: 1.0
}, onProgress ? (p) => onProgress(p * 0.5) : null);
// Stage 2: Firmer clipping closer to ceiling
result = applySoftClip(result, {
threshold: ceiling + 3, // -4 dB if ceiling is -1
ceiling: ceiling + 0.5, // -0.5 dB if ceiling is -1
drive: 1.8,
mix: 1.0
}, onProgress ? (p) => onProgress(0.5 + p * 0.5) : null);
return result;
}
/**
* Mastering-grade soft clipper with lookahead
* Uses sample-level lookahead to catch transients before they clip
*
* @param {AudioBuffer} buffer - Input audio buffer
* @param {Object} options - Clipper options
* @param {Function} onProgress - Progress callback
* @returns {AudioBuffer} Clipped audio buffer
*/
export function applyMasteringSoftClip(buffer, options = {}, onProgress = null) {
const {
ceiling = -1, // dB
lookaheadMs = 0.5, // ms - very short lookahead
releaseMs = 10, // ms - fast release
drive = 1.5
} = options;
const sampleRate = buffer.sampleRate;
const numChannels = buffer.numberOfChannels;
const length = buffer.length;
const ceilingLin = dbToLinear(ceiling);
const thresholdLin = dbToLinear(ceiling + 3); // Start 3dB above ceiling
const lookaheadSamples = Math.floor(sampleRate * lookaheadMs / 1000);
const releaseCoef = Math.exp(-1 / (releaseMs * sampleRate / 1000));
// Create output buffer
const outputBuffer = new AudioBuffer({
numberOfChannels: numChannels,
length: length,
sampleRate: sampleRate
});
// Process with lookahead gain reduction
const gainEnvelope = new Float32Array(length);
gainEnvelope.fill(1.0);
// First pass: calculate gain envelope from all channels
for (let ch = 0; ch < numChannels; ch++) {
const input = buffer.getChannelData(ch);
for (let i = 0; i < length; i++) {
const abs = Math.abs(input[i]);
if (abs > thresholdLin) {
// Calculate required gain reduction
const excess = abs - thresholdLin;
const range = ceilingLin - thresholdLin;
const normalized = excess / Math.max(range, 0.001);
const saturated = Math.tanh(normalized * drive);
const targetLevel = thresholdLin + saturated * range;
const requiredGain = targetLevel / abs;
// Apply to lookahead window
const startIdx = Math.max(0, i - lookaheadSamples);
for (let j = startIdx; j <= i; j++) {
// Interpolate gain reduction across lookahead
const t = (j - startIdx) / Math.max(1, i - startIdx);
const interpolatedGain = 1.0 + (requiredGain - 1.0) * t;
gainEnvelope[j] = Math.min(gainEnvelope[j], interpolatedGain);
}
}
}
}
// Smooth gain envelope with release
let currentGain = 1.0;
for (let i = 0; i < length; i++) {
if (gainEnvelope[i] < currentGain) {
currentGain = gainEnvelope[i];
} else {
currentGain = releaseCoef * currentGain + (1 - releaseCoef) * 1.0;
currentGain = Math.min(currentGain, 1.0);
}
gainEnvelope[i] = currentGain;
}
// Second pass: apply gain and final soft clip
for (let ch = 0; ch < numChannels; ch++) {
const input = buffer.getChannelData(ch);
const output = outputBuffer.getChannelData(ch);
// Apply 2x oversampling for final safety saturation
for (let i = 0; i < length; i++) {
const p0 = input[i - 2] || 0;
const p1 = input[i - 1] || 0;
const p2 = input[i];
const p3 = input[i + 1] || 0;
const p4 = input[i + 2] || 0;
// Apply gain envelope to context samples (approx)
const g0 = gainEnvelope[i - 2] || 1;
const g1 = gainEnvelope[i - 1] || 1;
const g2 = gainEnvelope[i];
const g3 = gainEnvelope[i + 1] || 1;
const g4 = gainEnvelope[i + 2] || 1;
const s0 = p1 * g1; // t=0
const s1 = p2 * g2; // t=1 (current)
// Calculate sample at i + 0.5
// To get t+0.5 we need 4 points: -1, 0, 1, 2
// Using indices relative to current i:
// Catmull(p1*g1, p2*g2, p3*g3, p4*g4, 0.5) -> value between p2 and p3 (i+0.5)
const sampleA = s1; // Original sample
const sampleB = interpolateCatmullRom(
p1 * g1,
p2 * g2,
p3 * g3,
p4 * g4,
0.5
);
// Apply saturation function
const saturate = (val) => {
const abs = Math.abs(val);
if (abs > ceilingLin) {
const excess = (abs - ceilingLin) / ceilingLin;
const reduction = 1 - Math.tanh(excess * 2) * 0.1;
return Math.sign(val) * Math.min(abs * reduction, ceilingLin);
}
return val;
};
const satA = saturate(sampleA);
const satB = saturate(sampleB);
// Downsample (Average)
output[i] = (satA + satB) * 0.5;
}
if (onProgress) {
onProgress((ch + 1) / numChannels);
}
}
return outputBuffer;
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |