Skip to content

GareBear99/MeterMaid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

12 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’Ž MeterMaid β€” free on GitHub + TizWildin website

MeterMaid is released free as part of the TizWildin Plugin Ecosystem.

Want to support the work directly? Any of these are appreciated:

πŸŽ›οΈ Part of the TizWildin Plugin Ecosystem β€” 19 free audio plugins with a live update dashboard.

FreeEQ8 Β· XyloCore Β· Instrudio Β· Therum Β· BassMaid Β· SpaceMaid Β· GlueMaid Β· MixMaid Β· MultiMaid Β· MeterMaid Β· ChainMaid Β· PaintMask Β· WURP Β· AETHER Β· WhisperGate Β· RiftWave Β· FreeSampler Β· VF-PlexLab Β· PAP-Forge-Audio

🎁 Free Packs & Samples β€” jump to free packs & samples

🎡 Awesome Audio β€” (FREE) Awesome Audio Dev List

MeterMaid

Position in the Maid Audio Lineup

MeterMaid is part of the Maid Audio suite, anchored by FreeEQ8:

Together, the Maid Audio suite is a complete, practical mixing + mastering toolkit: FreeEQ8 shapes tone, BassMaid owns the low end, SpaceMaid places sources in space, GlueMaid bonds the bus, MixMaid corrects spectral balance, MultiMaid tames multiband dynamics, MeterMaid verifies the result against broadcast and streaming targets, and ChainMaid routes the dynamic interaction between tracks.

A single-plugin mastering and metering suite built on rigorous loudness standards. ITU-R BS.1770-4 K-weighted loudness Β· EBU R128 gated integration Β· 4Γ— oversampled true peak Β· real-time spectrum Β· spectrogram Β· chromagram Β· goniometer Β· phase correlation Β· octagonal target radar.

CI License: MIT Platforms

What MeterMaid measures

MeterMaid gives you every reading a modern mastering engineer or streaming-target engineer needs from a single plugin window. Every metric below is computed from the same audio block on the audio thread and published lock-free to the UI.

Loudness (ITU-R BS.1770-4 / EBU R128)

  • Momentary LUFS (400 ms sliding window)
  • Short-Term LUFS (3 s sliding window)
  • Integrated LUFS with absolute (-70 LUFS) and relative (-10 LU) gating
  • LRA (Loudness Range, EBU R128 P95 βˆ’ P10)

Peaks and RMS

  • True Peak (4Γ— oversampled, IIR half-band): summed bus, and per-channel L / R
  • Sample Peak: per-channel L / R
  • RMS: per-channel L / R and summed mono

Dynamics and ratios

  • Crest Factor (true peak βˆ’ RMS)
  • Dynamic Range (short-term LUFS βˆ’ RMS)
  • PSR (Peak-to-Short-term Ratio, dB)
  • PLR (Peak-to-Loudness Ratio, dB)

Stereo image

  • Phase correlation (βˆ’1..+1)
  • Stereo width (side / total energy, %)
  • Goniometer (L/R rotated 45Β°)
  • Vectorscope (side / mid)

Spectral

  • Spectrum analyzer (512-bin Hann-windowed FFT, linear frequency axis)
  • Spectrogram (log-frequency, viridis heatmap, 256-frame history)
  • Chromagram (12 pitch classes over the piano range)

Time-based

  • Integrated LUFS timeline (512-point rolling history)
  • Loudness histogram (βˆ’48..0 LUFS in 1 dB buckets)

Decision layer

Rule-based target guidance that categorises the current material as one of:

State Meaning
Streaming Ready Integrated βˆ’16..βˆ’13 LUFS and true peak ≀ βˆ’1 dBTP
Too Loud Integrated > βˆ’13 LUFS
Too Quiet Integrated < βˆ’16 LUFS
True Peak Risk True peak > βˆ’1.0 dBTP
Stereo Risk Correlation < βˆ’0.10
Dynamic Pressure Dynamic range < 6 dB

The octagonal radar

The centrepiece visualisation. Eight labelled spokes β€” Integrated, Short-Term, Momentary, RMS, Dynamics, Correlation, Headroom, True Peak β€” each normalised to 0..1 against its target range. A filled polygon connects the live values so an at-risk mix shows an obvious asymmetry before you read a single number.

Install

  1. Grab the latest release from the releases page.
  2. Unzip and copy:
    • MeterMaid.vst3 β†’ ~/Library/Audio/Plug-Ins/VST3/
    • MeterMaid.component β†’ ~/Library/Audio/Plug-Ins/Components/
  3. Re-scan plugins in your DAW.

Standalone: MeterMaid.app β€” double-click to run.

Windows / Linux builds β€” planned. The CMake project is portable; CI currently targets macOS universal.

Standards compliance

MeterMaid implements loudness measurement against these published specifications:

  • ITU-R BS.1770-4 β€” pre-filter (high-shelf + high-pass K-weighting), mean square, gated block ring, logarithmic conversion.
  • EBU R128 / Tech 3342 β€” momentary (400 ms), short-term (3 s), integrated with absolute (βˆ’70 LUFS) and relative (βˆ’10 LU) gates; LRA as P95 βˆ’ P10 of gated short-term values.
  • ITU-R BS.1770-4 Annex 2 (true peak) β€” 4Γ— polyphase IIR half-band oversampling before the peak detector.

The K-weighting filter coefficients are the specification values (1681.97 Hz high-shelf at +4 dB, 38.14 Hz high-pass Q=0.5003) implemented as juce::dsp::IIR::Filter pairs, one per channel.

Validation status

This is a beta build. Numerical validation against reference meters is in progress; see MeterMaid/docs/TECHNICAL_AUDIT.md for the current audit and MeterMaid/docs/RELEASE_GATES.md for the full release gate checklist. The repository now ships an in-process calibration test (MeterMaid/tests/ReferenceToneTest.cpp) that synthesizes known-energy tones and asserts each reading is within Β±0.5 LU / Β±0.5 dBTP of the analytical expectation.

Honest claim: serious pre-production baseline with every MiniMeters-class readout implemented against the published standards, and an octagonal target radar that no other free metering plugin currently offers.

Unsafe claim without proof: "best in world" β€” that requires the validation matrix filled end-to-end and attached to a release.

Build from source

Requirements:

  • CMake 3.22+
  • A C++20 compiler (Xcode 14+ / CLT 14+ on macOS, MSVC 2022 on Windows, GCC 11+ on Linux)
  • JUCE 8.0.0
git clone https://github.com/GareBear99/MeterMaid.git
cd MeterMaid
git clone --depth 1 --branch 8.0.0 https://github.com/juce-framework/JUCE.git JUCE

cmake -S MeterMaid -B build \
  -DJUCE_PATH=$PWD/JUCE \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_OSX_ARCHITECTURES="arm64;x86_64" \
  -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0

cmake --build build --config Release --target MeterMaid_VST3 -j
cmake --build build --config Release --target MeterMaid_AU -j
cmake --build build --config Release --target MeterMaid_Standalone -j

Universal binaries land in build/MeterMaid_artefacts/Release/{VST3,AU,Standalone}/.

Run the calibration tests:

cmake -S MeterMaid -B build -DJUCE_PATH=$PWD/JUCE -DMETERMAID_BUILD_TESTS=ON
cmake --build build --target MeterMaid_ReferenceTest -j
./build/MeterMaid_ReferenceTest

Repository layout

MeterMaid/
β”œβ”€β”€ CMakeLists.txt
β”œβ”€β”€ Source/
β”‚   β”œβ”€β”€ PluginProcessor.{h,cpp}   β€” audio processor + framePipe owner
β”‚   β”œβ”€β”€ PluginEditor.{h,cpp}      β€” octagonal radar + full dashboard
β”‚   β”œβ”€β”€ MeterEngine.h             β€” K-weighting, gate, true peak, spectrum, chroma, LRA
β”‚   β”œβ”€β”€ MeterFrame.h              β€” audioβ†’UI payload
β”‚   └── LockFreeFramePipe.h       β€” double-buffered SPSC latest-frame pipe
β”œβ”€β”€ assets/                       β€” HTML UI reference demo
β”œβ”€β”€ config/                       β€” UI contract
β”œβ”€β”€ docs/                         β€” technical audit, release gates, audit plan
β”œβ”€β”€ tests/                        β€” reference tones + validation matrix
└── scripts/                      β€” validation harness
.github/workflows/build.yml       β€” macos-14 CI, universal-binary build + release attach

License

MIT β€” see LICENSE. The K-weighting coefficients and gating procedure are from publicly published ITU / EBU specifications and are implemented from scratch.

Support and ecosystem

TizWildin FREE sample packs

Pack Description
TizWildin-Aurora 3-segment original synth melody pack with loops, stems, demo renders, and neon/cinematic phrasing
TizWildin-Obsidian Dark cinematic sample pack with choir textures, menu loops, transitions, bass, atmosphere, drums, and electric-banjo extensions
TizWildin-Skyline 30 BPM-tagged synthwave and darkwave loops with generator snapshot and dark neon additions
TizWildin-Chroma Multi-segment game synthwave loop sample pack from TizWildin Entertainment
TizWildin-Chime Multi-part 88 BPM chime collection spanning glass, void, halo, reed, and neon synthwave lanes
Free Violin Synth Sample Kit Physical-model violin sample kit rendered from the Instrudio violin instrument
Free Dark Piano Sound Kit 88 piano notes + dark/cinematic loops and MIDI
Free 808 Producer Kit 94 hand-crafted 808 bass samples tuned to every chromatic key
Free Riser Producer Kit 115+ risers and 63 downlifters - noise, synth, drum, FX, cinematic
Phonk Producer Toolkit Drift phonk starter kit - 808s, cowbells, drums, MIDI, templates
Free Future Bass Producer Kit Loops, fills, drums, bass, synths, pads, and FX

Related audio projects

  • VF-PlexLab - VocalForge PersonaPlex Lab starter repo for a JUCE plugin + local backend + HTML tester around NVIDIA PersonaPlex.

About

Full Metering Suite inside a JUCE plugin

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors