diff --git a/app/api/v1/plugins.py b/app/api/v1/plugins.py
index eaaf3f6..c9bd885 100644
--- a/app/api/v1/plugins.py
+++ b/app/api/v1/plugins.py
@@ -607,6 +607,15 @@ async def download_soundfont_asset(sf_id: str):
class RenderRequest(BaseModel):
project_json: dict
output_filename: Optional[str] = "render_output.wav"
+ # D3 export options: bit-depth 16|24|32 (32 = float), SR 44100|48000|96000,
+ # dither TPDF+noise shaping (PCM only), normalize target -1dBTP|-14LUFS,
+ # mono-compat check (side/mid ratio).
+ bit_depth: Optional[int] = 32
+ sample_rate: Optional[int] = 0
+ dither: Optional[bool] = False
+ normalize: Optional[bool] = False
+ normalize_target: Optional[str] = "-1dbtp"
+ mono_check: Optional[bool] = False
class FxGuiRequest(BaseModel):
@@ -1180,7 +1189,14 @@ def render_project(
safe_name += ".wav"
output_path = os.path.join(settings.PROCESSED_DIR, safe_name)
try:
- result_path = engine.render_project(req.project_json, output_path)
+ result_path = engine.render_project(
+ req.project_json, output_path,
+ bit_depth=req.bit_depth or 32,
+ out_sample_rate=req.sample_rate or 0,
+ dither=bool(req.dither),
+ normalize=bool(req.normalize),
+ normalize_target=req.normalize_target or "-1dbtp",
+ )
# EBU R128 loudness + true peak (D1) — trả kèm response để mastering
# panel hiển thị LUFS/dBTP ngay sau export mà không cần đọc lại file.
data, _sr = sf.read(result_path, dtype="float32", always_2d=True)
@@ -1194,6 +1210,18 @@ def render_project(
_tp = loudness.true_peak_db(audio, _sr)
resp["lufs"] = round(_lufs, 2) if np.isfinite(_lufs) else None
resp["true_peak_db"] = round(_tp, 2) if np.isfinite(_tp) else None
+ # D3: mono-compat — side/mid RMS ratio, cảnh báo khi sum mono mất nhiều.
+ if req.mono_check and data.shape[1] >= 2:
+ _ratio = loudness.mono_side_ratio(data.T)
+ resp["mono_side_ratio"] = round(_ratio, 3)
+ if _ratio > 0.85:
+ resp["mono_warning"] = ("Side/Mid %.2f — mono sum mất gần hết "
+ "âm thanh, kiểm tra phase!" % _ratio)
+ elif _ratio > 0.5:
+ resp["mono_warning"] = ("Side/Mid %.2f — âm thanh phát mono "
+ "yếu rõ, kiểm tra phase" % _ratio)
+ else:
+ resp["mono_warning"] = None
return resp
except Exception as e:
raise HTTPException(status_code=500, detail=f"Render failed: {str(e)}")
diff --git a/app/core/loudness.py b/app/core/loudness.py
index 3979fbc..188f4ce 100644
--- a/app/core/loudness.py
+++ b/app/core/loudness.py
@@ -78,6 +78,20 @@ def integrated_lufs(audio: np.ndarray, sr: float) -> float:
return float(-0.691 + 10.0 * np.log10(np.mean(gated)))
+def mono_side_ratio(audio: np.ndarray) -> float:
+ """Side/Mid RMS ratio (D3 mono-compat). 0 = mono-safe (L==R); >1 = side
+ louder than mid — mono sum mất nhiều âm thanh."""
+ audio = np.asarray(audio, dtype=np.float64)
+ if audio.ndim == 1:
+ audio = audio[np.newaxis, :]
+ if audio.shape[0] < 2 or audio.shape[1] == 0:
+ return 0.0
+ mid = (audio[0] + audio[1]) * 0.5
+ side = (audio[0] - audio[1]) * 0.5
+ m = float(np.sqrt(np.mean(mid ** 2))) + 1e-12
+ return float(np.sqrt(np.mean(side ** 2))) / m
+
+
def true_peak_db(audio: np.ndarray, sr: float, oversample: int = 4) -> float:
"""True peak in dBTP (4x oversample). -inf for digital silence."""
audio = np.asarray(audio, dtype=np.float64)
diff --git a/app/core/render_engine.py b/app/core/render_engine.py
index 10e7358..8521e4b 100644
--- a/app/core/render_engine.py
+++ b/app/core/render_engine.py
@@ -375,6 +375,31 @@ def _probe_track_latency(track, sample_rate):
except Exception:
pass
+def _quantize_pcm(audio, bits, dither):
+ """Quantize float [-1,1] to PCM grid (bits=16|24), optional TPDF dither +
+ 1st-order noise shaping. Tra ve int array de sf.write ghi EXACT bits
+ (libsndfile float->PCM khong round dung 32768-grid - kiem chung D3)."""
+ N = 2 ** (bits - 1)
+ x = audio.astype(np.float64)
+ if dither and bits < 32:
+ lsb = 1.0 / N
+ rng = np.random.default_rng()
+ d = (rng.random(x.shape) + rng.random(x.shape) - 1.0) * lsb # TPDF [-lsb, lsb]
+ out = np.empty_like(x)
+ err = np.zeros(x.shape[0])
+ for i in range(x.shape[1]):
+ s = x[:, i] + d[:, i] + err
+ q = np.rint(s * N)
+ out[:, i] = q
+ err = q / N - s # 1st-order noise shaping feedback
+ q = np.clip(out, -N, N - 1)
+ else:
+ q = np.clip(np.rint(x * N), -N, N - 1)
+ if bits == 16:
+ return q.astype(np.int16)
+ # PCM_24: libsndfile luu top-24-bit cua int32 -> <<8
+ return (q.astype(np.int64) << 8).astype(np.int32)
+
class PythonRenderEngine:
def __init__(self, sample_rate=44100):
self.sample_rate = sample_rate
@@ -765,7 +790,10 @@ class PythonRenderEngine:
return session_buffer
- def render_project(self, project_json: dict, output_filepath: str):
+ def render_project(self, project_json: dict, output_filepath: str,
+ bit_depth: int = 32, out_sample_rate: int = 0,
+ dither: bool = False, normalize: bool = False,
+ normalize_target: str = "-1dbtp"):
with RENDER_LOCK:
bpm = project_json["metadata"]["bpm"]
time_sig_num = project_json["metadata"].get("time_signature_numerator", 4)
@@ -854,6 +882,31 @@ class PythonRenderEngine:
if max_peak > 1.0:
master_buffer /= max_peak
- # Write final output file
- sf.write(output_filepath, master_buffer.T, self.sample_rate, subtype="FLOAT")
+ # ── D3 export stage: resample / normalize / dither / PCM ──
+ out_sr = out_sample_rate or self.sample_rate
+ if out_sr != self.sample_rate:
+ from scipy.signal import resample_poly
+ g = math.gcd(int(out_sr), int(self.sample_rate))
+ master_buffer = resample_poly(
+ master_buffer, int(out_sr) // g, int(self.sample_rate) // g, axis=1)
+ if normalize:
+ from app.core import loudness
+ if normalize_target == "-14lufs":
+ _l = loudness.integrated_lufs(master_buffer, out_sr)
+ if np.isfinite(_l):
+ master_buffer *= 10 ** ((-14.0 - _l) / 20.0)
+ else: # "-1dbtp"
+ _tp = loudness.true_peak_db(master_buffer, out_sr)
+ if np.isfinite(_tp):
+ master_buffer *= 10 ** ((-1.0 - _tp) / 20.0)
+
+ # Write final output file (D3: PCM_16/PCM_24 + dither, FLOAT mac dinh)
+ if bit_depth == 16:
+ sf.write(output_filepath, _quantize_pcm(master_buffer, 16, dither).T,
+ out_sr, subtype="PCM_16")
+ elif bit_depth == 24:
+ sf.write(output_filepath, _quantize_pcm(master_buffer, 24, dither).T,
+ out_sr, subtype="PCM_24")
+ else:
+ sf.write(output_filepath, master_buffer.T, out_sr, subtype="FLOAT")
return output_filepath
diff --git a/app/static/js/app.jsx b/app/static/js/app.jsx
index e2b57f8..0c74040 100644
--- a/app/static/js/app.jsx
+++ b/app/static/js/app.jsx
@@ -11971,7 +11971,7 @@ const InteractiveEqPro = ({ track, params, onChange, getModule, applyTo, spectru
);
};
-const ExportModal = ({ open, onClose, exportSettings, setExportSettings, isExporting, onExport, onBounce }) => {
+const ExportModal = ({ open, onClose, exportSettings, setExportSettings, isExporting, onExport, onBounce, onRenderMastering }) => {
if (!open) return null;
return (
@@ -12011,15 +12011,15 @@ const ExportModal = ({ open, onClose, exportSettings, setExportSettings, isExpor
+
-
+
+