Double-click Launch Postmaster.cmd. Your browser opens at http://127.0.0.1:8776. Keep the server window running; close it to stop the app. Requires Python 3.10+ and FFmpeg/ffprobe on PATH (already present on the development computer). No pip packages, accounts, API keys or internet access are required.
- Drop a finished mono or stereo mix into Source Library. Multiple files are supported.
- Select loudness, EQ, stereo width, optional compression/restoration and fades.
- Select WAV, FLAC, MP3, AAC/M4A or Opus outputs, then Render Master.
- Compare DRY / MASTER with level match enabled. Controls require a new render before they affect playback. Monitor volume and mono audition never alter exports.
- Download individual files or the ZIP. Each delivery includes actual full-track loudness and true-peak measurements; JSON reports preserve the processing settings.
Render all source tracks runs the current settings on each source sequentially. It stops on an error, preserving completed results. A loaded reference is excluded. Save preset / Load preset transfers settings as JSON. Every successful render is retained and can be auditioned again.
Original source → input gain → optional adaptive de-click → optional FFT denoise → 2-pole high-pass → ten minimum-phase parametric EQ bands (Q=1) → mid/side width → optional stereo-linked RMS compressor → fades → two-pass EBU R128 loudness normalization → encoding/dither → independent output measurement.
Normalization uses linear gain where constraints permit and FFmpeg's dynamic normalization otherwise. Loudness-range target is a processing constraint, not a promise to expand dynamics. Disable normalization for a manual-gain render; then the ceiling setting does not act as a limiter. The app reports true peak and LUFS from FFmpeg, not from a cosmetic meter. No clipping repair or transparent restoration is guaranteed.
WAV supports 16/24-bit integer and 32-bit float. FLAC is capped at 24-bit. TPDF dither applies to integer exports only. MP3/AAC export at 48 kHz; Opus decodes at 48 kHz. Lossy encoding and resampling may overshoot the requested ceiling: inspect the individual output measurements and lower the ceiling if needed. Silent audio can be exported but has no integrated LUFS. Very short clips have limited loudness/LRA usefulness. Surround input is rejected rather than silently downmixed.
Audio previews are 16-bit/48 kHz PCM for browser compatibility. Level match attenuates the louder audition based on integrated loudness. It is not sample-accurate instant switching: source switches reload the audio element at the same timestamp. Spectrum and stereo scope are live audition measurements before monitor processing. Waveforms are reduced-rate navigation views, not peak meters. Playback does not provide live mastering DSP; rendering is offline.
All audio stays local. The server binds only to loopback, validates Host/Origin for requests, requires a per-launch token for writes, and restricts media paths. Browser tabs on other sites cannot submit mastering jobs. Import decoding restricts FFmpeg input protocols to local files/pipes.
sessions/ holds copied sources, playback WAVs, analysis, exports and ZIPs. Reloading restores the library and previous renders. Browser local storage holds current controls and the reference selection. Files are retained until you remove them manually; stop the app before deleting session folders. Large files, preview WAVs and multiple renders can consume substantial disk space. Limits are 2 GB per upload and two hours per track. Work is serialized to avoid simultaneous heavy encodes; render progress is stage-based, not an exact ETA. Failed jobs may leave an incomplete session folder. A browser refresh does not cancel a running job; reload again after completion to see its result.
This working local edition carries forward the original dark/neon three-column studio concept. The supplied prototype is preserved as Original-UI.html for design reference. Its simulated AI spectral inpainting, room models, cloud processing, BPM/key guesses, DSD and Atmos export are not implemented or presented as functioning features. There is no linear-phase EQ or live look-ahead limiter in this edition.
server.py: standard-library local API and FFmpeg processing pipeline.index.html,style.css,app.js: framework-free studio UI.Launch Postmaster.cmd: Windows launcher.tests.py: signal-based engine and HTTP integration checks. Runpython tests.py.
If port 8776 is occupied, close the existing Postmaster instance, or set POSTMASTER_PORT to another local port before launching. Restarting interrupts jobs; completed exports remain on disk.