{"id":49692763,"url":"https://github.com/GareBear99/MeterMaid","last_synced_at":"2026-05-24T09:01:29.660Z","repository":{"id":347254280,"uuid":"1193232338","full_name":"GareBear99/MeterMaid","owner":"GareBear99","description":"Full Metering Suite inside a JUCE plugin","archived":false,"fork":false,"pushed_at":"2026-04-23T07:06:39.000Z","size":69,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-23T08:29:53.380Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GareBear99.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-27T02:21:10.000Z","updated_at":"2026-04-23T07:06:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/GareBear99/MeterMaid","commit_stats":null,"previous_names":["garebear99/metermaid"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GareBear99/MeterMaid","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareBear99%2FMeterMaid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareBear99%2FMeterMaid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareBear99%2FMeterMaid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareBear99%2FMeterMaid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GareBear99","download_url":"https://codeload.github.com/GareBear99/MeterMaid/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareBear99%2FMeterMaid/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33427584,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-07T19:00:34.333Z","updated_at":"2026-05-24T09:01:29.647Z","avatar_url":"https://github.com/GareBear99.png","language":"C++","funding_links":["https://github.com/sponsors/GareBear99","https://buymeacoffee.com/garebear99","https://ko-fi.com/luciferai"],"categories":["Featured ecosystem"],"sub_categories":["[TizWildin Entertainment HUB](https://github.com/GareBear99/TizWildinEntertainmentHUB)"],"readme":"\u003c!-- tizwildin-pricing:start --\u003e\n## 💎 MeterMaid — **free** on GitHub + TizWildin website\n\nMeterMaid is released **free** as part of the TizWildin Plugin Ecosystem.\n\n- [⬇️ Latest release](https://github.com/GareBear99/MeterMaid/releases/latest) — universal macOS VST3 + AU + Standalone\n- [🌐 TizWildin website](https://garebear99.github.io/TizWildinEntertainmentHUB/)\n- [🏛️ TizWildin Hub repo](https://github.com/GareBear99/TizWildinEntertainmentHUB)\n\nWant to support the work directly? Any of these are appreciated:\n\n- [GitHub Sponsors](https://github.com/sponsors/GareBear99)\n- [Buy Me a Coffee](https://buymeacoffee.com/garebear99)\n- [Ko-fi](https://ko-fi.com/luciferai)\n\u003c!-- tizwildin-pricing:end --\u003e\n\n\u003e 🎛️ Part of the [TizWildin Plugin Ecosystem](https://garebear99.github.io/TizWildinEntertainmentHUB/) — 19 free audio plugins with a live update dashboard.\n\u003e\n\u003e [FreeEQ8](https://github.com/GareBear99/FreeEQ8) · [XyloCore](https://github.com/GareBear99/XyloCore) · [Instrudio](https://github.com/GareBear99/Instrudio) · [Therum](https://github.com/GareBear99/Therum_JUCE-Plugin) · [BassMaid](https://github.com/GareBear99/BassMaid) · [SpaceMaid](https://github.com/GareBear99/SpaceMaid) · [GlueMaid](https://github.com/GareBear99/GlueMaid) · [MixMaid](https://github.com/GareBear99/MixMaid) · [MultiMaid](https://github.com/GareBear99/MultiMaid) · [MeterMaid](https://github.com/GareBear99/MeterMaid) · [ChainMaid](https://github.com/GareBear99/ChainMaid) · [PaintMask](https://github.com/GareBear99/PaintMask_Free-JUCE-Plugin) · [WURP](https://github.com/GareBear99/WURP_Toxic-Motion-Engine_JUCE) · [AETHER](https://github.com/GareBear99/AETHER_Choir-Atmosphere-Designer) · [WhisperGate](https://github.com/GareBear99/WhisperGate_Free-JUCE-Plugin) · [RiftWave](https://github.com/GareBear99/RiftWaveSuite_RiftSynth_WaveForm_Lite) · [FreeSampler](https://github.com/GareBear99/FreeSampler_v0.3) · [VF-PlexLab](https://github.com/GareBear99/VF-PlexLab) · [PAP-Forge-Audio](https://github.com/GareBear99/PAP-Forge-Audio)\n\u003e\n\u003e 🎁 [Free Packs \u0026 Samples](#tizwildin-free-sample-packs) — jump to free packs \u0026 samples\n\u003e\n\u003e 🎵 [Awesome Audio](https://github.com/GareBear99/awesome-audio-plugins-dev) — (FREE) Awesome Audio Dev List\n\n# MeterMaid\n\n## Position in the Maid Audio Lineup\n\nMeterMaid is part of the Maid Audio suite, anchored by FreeEQ8:\n\n- **FreeEQ8** — flagship 8-band parametric EQ (anchors the suite) · [https://github.com/GareBear99/FreeEQ8](https://github.com/GareBear99/FreeEQ8)\n- **BassMaid** — low-end enhancement, sub reinforcement, tightening · [https://github.com/GareBear99/BassMaid](https://github.com/GareBear99/BassMaid)\n- **SpaceMaid** — depth, width, ambience, spatial design · [https://github.com/GareBear99/SpaceMaid](https://github.com/GareBear99/SpaceMaid)\n- **GlueMaid** — mix-bus glue and cohesion · [https://github.com/GareBear99/GlueMaid](https://github.com/GareBear99/GlueMaid)\n- **MixMaid** — real-time spectral balance and mix correction · [https://github.com/GareBear99/MixMaid](https://github.com/GareBear99/MixMaid)\n- **MultiMaid** — focused multiband dynamics, non-overlapping with the rest · [https://github.com/GareBear99/MultiMaid](https://github.com/GareBear99/MultiMaid)\n- **MeterMaid** — ITU-R BS.1770-4 / EBU R128 mastering + metering suite with an octagonal target radar · [https://github.com/GareBear99/MeterMaid](https://github.com/GareBear99/MeterMaid) ← *you are here*\n- **ChainMaid** — sidechain ducking, pumping, and trigger routing · [https://github.com/GareBear99/ChainMaid](https://github.com/GareBear99/ChainMaid)\n\nTogether, the Maid Audio suite is a complete, practical mixing + mastering toolkit:\nFreeEQ8 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.\n\n**A single-plugin mastering and metering suite built on rigorous loudness standards.**\nITU-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.\n\n[![CI](https://github.com/GareBear99/MeterMaid/actions/workflows/build.yml/badge.svg)](https://github.com/GareBear99/MeterMaid/actions/workflows/build.yml)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Platforms](https://img.shields.io/badge/platforms-macOS%20universal-lightgrey.svg)](#install)\n\n## What MeterMaid measures\n\nMeterMaid 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.\n\n### Loudness (ITU-R BS.1770-4 / EBU R128)\n- **Momentary LUFS** (400 ms sliding window)\n- **Short-Term LUFS** (3 s sliding window)\n- **Integrated LUFS** with absolute (-70 LUFS) and relative (-10 LU) gating\n- **LRA** (Loudness Range, EBU R128 P95 − P10)\n\n### Peaks and RMS\n- **True Peak** (4× oversampled, IIR half-band): summed bus, and per-channel L / R\n- **Sample Peak**: per-channel L / R\n- **RMS**: per-channel L / R and summed mono\n\n### Dynamics and ratios\n- **Crest Factor** (true peak − RMS)\n- **Dynamic Range** (short-term LUFS − RMS)\n- **PSR** (Peak-to-Short-term Ratio, dB)\n- **PLR** (Peak-to-Loudness Ratio, dB)\n\n### Stereo image\n- **Phase correlation** (−1..+1)\n- **Stereo width** (side / total energy, %)\n- **Goniometer** (L/R rotated 45°)\n- **Vectorscope** (side / mid)\n\n### Spectral\n- **Spectrum analyzer** (512-bin Hann-windowed FFT, linear frequency axis)\n- **Spectrogram** (log-frequency, viridis heatmap, 256-frame history)\n- **Chromagram** (12 pitch classes over the piano range)\n\n### Time-based\n- **Integrated LUFS timeline** (512-point rolling history)\n- **Loudness histogram** (−48..0 LUFS in 1 dB buckets)\n\n### Decision layer\nRule-based target guidance that categorises the current material as one of:\n\n| State | Meaning |\n|---|---|\n| `Streaming Ready` | Integrated −16..−13 LUFS and true peak ≤ −1 dBTP |\n| `Too Loud` | Integrated \u003e −13 LUFS |\n| `Too Quiet` | Integrated \u003c −16 LUFS |\n| `True Peak Risk` | True peak \u003e −1.0 dBTP |\n| `Stereo Risk` | Correlation \u003c −0.10 |\n| `Dynamic Pressure` | Dynamic range \u003c 6 dB |\n\n### The octagonal radar\nThe 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.\n\n## Install\n\n1. Grab the latest release from [the releases page](https://github.com/GareBear99/MeterMaid/releases/latest).\n2. Unzip and copy:\n   - `MeterMaid.vst3` → `~/Library/Audio/Plug-Ins/VST3/`\n   - `MeterMaid.component` → `~/Library/Audio/Plug-Ins/Components/`\n3. Re-scan plugins in your DAW.\n\nStandalone: `MeterMaid.app` — double-click to run.\n\n*Windows / Linux builds — planned. The CMake project is portable; CI currently targets macOS universal.*\n\n## Standards compliance\n\nMeterMaid implements loudness measurement against these published specifications:\n\n- **ITU-R BS.1770-4** — pre-filter (high-shelf + high-pass K-weighting), mean square, gated block ring, logarithmic conversion.\n- **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.\n- **ITU-R BS.1770-4 Annex 2 (true peak)** — 4× polyphase IIR half-band oversampling before the peak detector.\n\nThe 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.\n\n## Validation status\n\nThis is a beta build. Numerical validation against reference meters is in progress; see [`MeterMaid/docs/TECHNICAL_AUDIT.md`](MeterMaid/docs/TECHNICAL_AUDIT.md) for the current audit and [`MeterMaid/docs/RELEASE_GATES.md`](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.\n\n**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.\n\n**Unsafe claim without proof:** \"best in world\" — that requires the validation matrix filled end-to-end and attached to a release.\n\n## Build from source\n\nRequirements:\n- CMake 3.22+\n- A C++20 compiler (Xcode 14+ / CLT 14+ on macOS, MSVC 2022 on Windows, GCC 11+ on Linux)\n- [JUCE 8.0.0](https://github.com/juce-framework/JUCE/tree/8.0.0)\n\n```bash path=null start=null\ngit clone https://github.com/GareBear99/MeterMaid.git\ncd MeterMaid\ngit clone --depth 1 --branch 8.0.0 https://github.com/juce-framework/JUCE.git JUCE\n\ncmake -S MeterMaid -B build \\\n  -DJUCE_PATH=$PWD/JUCE \\\n  -DCMAKE_BUILD_TYPE=Release \\\n  -DCMAKE_OSX_ARCHITECTURES=\"arm64;x86_64\" \\\n  -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0\n\ncmake --build build --config Release --target MeterMaid_VST3 -j\ncmake --build build --config Release --target MeterMaid_AU -j\ncmake --build build --config Release --target MeterMaid_Standalone -j\n```\n\nUniversal binaries land in `build/MeterMaid_artefacts/Release/{VST3,AU,Standalone}/`.\n\nRun the calibration tests:\n\n```bash path=null start=null\ncmake -S MeterMaid -B build -DJUCE_PATH=$PWD/JUCE -DMETERMAID_BUILD_TESTS=ON\ncmake --build build --target MeterMaid_ReferenceTest -j\n./build/MeterMaid_ReferenceTest\n```\n\n## Repository layout\n\n```\nMeterMaid/\n├── CMakeLists.txt\n├── Source/\n│   ├── PluginProcessor.{h,cpp}   — audio processor + framePipe owner\n│   ├── PluginEditor.{h,cpp}      — octagonal radar + full dashboard\n│   ├── MeterEngine.h             — K-weighting, gate, true peak, spectrum, chroma, LRA\n│   ├── MeterFrame.h              — audio→UI payload\n│   └── LockFreeFramePipe.h       — double-buffered SPSC latest-frame pipe\n├── assets/                       — HTML UI reference demo\n├── config/                       — UI contract\n├── docs/                         — technical audit, release gates, audit plan\n├── tests/                        — reference tones + validation matrix\n└── scripts/                      — validation harness\n.github/workflows/build.yml       — macos-14 CI, universal-binary build + release attach\n```\n\n## License\n\nMIT — see [LICENSE](LICENSE). The K-weighting coefficients and gating procedure are from publicly published ITU / EBU specifications and are implemented from scratch.\n\n## Support and ecosystem\n\n- **Report issues**: [GitHub Issues](https://github.com/GareBear99/MeterMaid/issues)\n- **Changelog**: [CHANGELOG.md](CHANGELOG.md)\n- **Other TizWildin plugins**: [TizWildin Hub](https://garebear99.github.io/TizWildinEntertainmentHUB/)\n- **Awesome Audio Dev list**: [awesome-audio-plugins-dev](https://github.com/GareBear99/awesome-audio-plugins-dev)\n\n## TizWildin FREE sample packs\n\n| Pack | Description |\n|------|-------------|\n| [**TizWildin-Aurora**](https://github.com/GareBear99/TizWildin-Aurora) | 3-segment original synth melody pack with loops, stems, demo renders, and neon/cinematic phrasing |\n| [**TizWildin-Obsidian**](https://github.com/GareBear99/TizWildin-Obsidian) | Dark cinematic sample pack with choir textures, menu loops, transitions, bass, atmosphere, drums, and electric-banjo extensions |\n| [**TizWildin-Skyline**](https://github.com/GareBear99/TizWildin-Skyline) | 30 BPM-tagged synthwave and darkwave loops with generator snapshot and dark neon additions |\n| [**TizWildin-Chroma**](https://github.com/GareBear99/TizWildin-Chroma) | Multi-segment game synthwave loop sample pack from TizWildin Entertainment |\n| [**TizWildin-Chime**](https://github.com/GareBear99/TizWildin-Chime) | Multi-part 88 BPM chime collection spanning glass, void, halo, reed, and neon synthwave lanes |\n| [**Free Violin Synth Sample Kit**](https://github.com/GareBear99/Free-Violin-Synth-Sample-Kit) | Physical-model violin sample kit rendered from the Instrudio violin instrument |\n| [**Free Dark Piano Sound Kit**](https://github.com/GareBear99/Free-Dark-Piano-Sound-Kit) | 88 piano notes + dark/cinematic loops and MIDI |\n| [**Free 808 Producer Kit**](https://github.com/GareBear99/Free-808-Producer-Kit) | 94 hand-crafted 808 bass samples tuned to every chromatic key |\n| [**Free Riser Producer Kit**](https://github.com/GareBear99/Free-Riser-Producer-Kit) | 115+ risers and 63 downlifters - noise, synth, drum, FX, cinematic |\n| [**Phonk Producer Toolkit**](https://github.com/GareBear99/Phonk_Producer_Toolkit) | Drift phonk starter kit - 808s, cowbells, drums, MIDI, templates |\n| [**Free Future Bass Producer Kit**](https://github.com/GareBear99/Free-Future-Bass-Producer-Kit) | Loops, fills, drums, bass, synths, pads, and FX |\n\n### Related audio projects\n- [**VF-PlexLab**](https://github.com/GareBear99/VF-PlexLab) - VocalForge PersonaPlex Lab starter repo for a JUCE plugin + local backend + HTML tester around NVIDIA PersonaPlex.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGareBear99%2FMeterMaid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGareBear99%2FMeterMaid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGareBear99%2FMeterMaid/lists"}