A cohesive, laboratory-grade, lightweight family of real-time audio analysis, visualization, and signal instrumentation tools for SuperCollider.
Probe prioritizes audio-thread safety (scsynth), predictable resource lifecycle, centralized analysis sharing, and pristine IDE autocomplete ergonomics—with zero mandatory C++ compilation, zero external binary dependencies, and zero modifications to stock SuperCollider files.
For full architectural details, see the Implementation Architecture & Dual-Tier Design.
| Oscilloscope Trigger Stabilization | 16-Band Octave Analyzer |
|---|---|
![]() |
![]() |
| Static DSP Graph Inspector | Advanced Spectral Dashboard |
|---|---|
![]() |
![]() |
| Precision Line FFT Spectrum | 2.5D Waterfall Spectrum |
|---|---|
![]() |
![]() |
// Boot default server
s.boot;
// Play test signal
x = { Saw.ar([110, 110.5]) * 0.25 }.play;
// Open instruments via Server Shortcuts
s.meterPb; // Vertical Server Meter
s.scopePb; // Oscilloscope with Trigger Stabilization
s.freqscopePb; // 3-Mode Spectrum Analyzer
s.spectralDashboardPb; // 4-Preset Spectral Dashboard
s.dashboardPb; // 5-Panel Command Center
s.loudnessPb; // EBU R128 Loudness Meter
// Transparent In-Graph Signal Tracing (.trace)
y = {
var lfo = SinOsc.kr(1.5).range(200, 2000).trace(\cutoff); // 20 Hz scrolling HUD
var sig = Saw.ar(110).trace(\rawOsc); // Sample-accurate scope
RLPF.ar(sig, lfo, 0.2);
}.play;
// Static DSP Graph Inspection
s.inspectPb(y.def);Embed visualizers directly into custom GUI layouts without importing internal plumbing classes:
w = Window("Custom Mastering Layout", Rect(100, 100, 800, 400)).front;
w.layout = HLayout(
ProbeMeter.view(w, numIns: 0, numOuts: 2),
ProbeScope.view(w, busIndex: 0, numChannels: 2),
ProbeSpectrum.view(w, busIndex: 0)
);Multiple visualizers monitoring the same server bus automatically share a single analysis Synth:
┌───────────────────────────────┐
│ scsynth Audio Bus │
└───────────────┬───────────────┘
│
┌───────────────▼───────────────┐
│ PB_Broker │
└───────┬───────────────┬───────┘
│ │
┌──────────────▼──────┐ ┌──────▼───────────────┐
│ PB_SpectrumSource │ │ PB_LoudnessSource │
└──────┬──────────────┘ └──────┬───────────────┘
│ │
┌────────┴────────┐ │
┌─────▼─────────┐ ┌─────▼─────────┐ ┌──▼───────────────┐
│ PB_Spectrogram│ │ PB_Waterfall │ │ PB_LoudnessView │
└───────────────┘ └───────────────┘ └──────────────────┘
- Zero Duplicate Synths: Opening Spectrogram, Waterfall, and Spectrum together never creates redundant FFT nodes.
- Reference Counting: Sources start on first subscriber and automatically free when all subscribers close.
- Fail-Safe Lifecycle: Clean recovery on
CmdPeriodandServerQuit.
Probe provides seven immutable, scientifically calibrated palettes:
- Graphite (Default): Sleek dark studio aesthetic (
#171A20). - Phosphor: Vintage green monochrome CRT glow (
#09140F). - Ice: Crisp Nordic blue-cyan technical readout (
#101A2A). - Amber: Warm vintage mastering console (
#1A1712). - Paper: High-contrast light mode for daytime work and publication printing (
#F1EDE2). - Monochrome: Minimalist grayscale (
#111111). - Pure Data: Stark black-and-white minimalist low-res aesthetic with monospace typography (
#FFFFFFcanvas with solid#000000signal traces and controls).
All instruments support dynamic font scaling (1.0 to 2.0, default 1.25) and dynamic theme switching via .theme = \puredata.
| Measurement | Standard / Definition | Window / Ballistics | Range / Units |
|---|---|---|---|
| Peak | Unwindowed absolute sample maximum | Instantaneous ($O(1)$) |
|
| RMS | Root mean square energy | 100 ms ( |
|
| Momentary Loudness (M) | ITU-R BS.1770-4 K-weighting | 400 ms sliding rectangular |
|
| Short-Term Loudness (S) | ITU-R BS.1770-4 K-weighting | 3.0 s sliding rectangular |
|
| Integrated Loudness (I) | ITU-R BS.1770 / EBU R128 | Dual-gated ( |
Target: |
| Loudness Range (LRA) | EBU Tech 3342 | 95th minus 10th percentile of |
|
| Spectral Centroid | Frequency-weighted spectral mean | Magnitude-weighted FFT frame | Hz / kHz |
| Phase Correlation | Normalized cross-correlation | 250 ms integration |
|
// Install Quark via GitHub
Quarks.install("https://github.com/fmiramar/Probe");
// Or install from local path
Quarks.install("~/Desktop/SC New Visulations servers/Probe");
// Recompile Class Library
thisProcess.recompile;
// Run Master Test Suite (14 Suites Passing Cleanly)
"tests/run_all_tests.scd".loadRelative;
// Verify System-Wide Health (101 Assertions Passing)
"scripts/verify_system_install.scd".loadRelative;The comprehensive Probe - Visuals and Representation Suite Guide covers in-depth class references, in-graph .trace workflows for filters and analytic UGens, and GUI embedding architecture.
Full class documentation is integrated directly into the SuperCollider Help browser (Cmd+D):
Probe.help;
ProbeScope.help;
ProbeSpectralDashboard.help;
ProbeInspector.help;
// Open the comprehensive Suite Guide
"Probe - Visuals and Representation Suite".help;GNU General Public License v3.0 or later (LICENSE).






