WaveScope

Vintage bench-style oscilloscope plugin and standalone app for real-time audio waveform monitoring.

WaveScope is a pass-through effect with a hardware-inspired CRT UI, built for quick waveform inspection inside a DAW or as a standalone desktop app.

Quick Start

Pick your OS and expand the steps:

macOS

Prerequisites:

• Homebrew
• cmake
• Xcode Command Line Tools

Install and run:

git clone https://github.com/EyalDelarea/WaveScope.git
cd WaveScope
brew install cmake
xcode-select --install
make run

Build outputs:

• Standalone app: build/WaveScope_artefacts/<Debug|Release>/Standalone/WaveScope.app
• Plug-ins: AU, VST3

By default, macOS builds also copy plug-ins into:

• ~/Library/Audio/Plug-Ins/Components/
• ~/Library/Audio/Plug-Ins/VST3/

Windows

Prerequisites:

• Visual Studio 2022
• Desktop development with C++
• CMake

Install and run:

git clone https://github.com/EyalDelarea/WaveScope.git
cd WaveScope
cmake -B build -DCMAKE_BUILD_TYPE=Release -DWAVESCOPE_COPY_AFTER_BUILD=OFF
cmake --build build --config Release
build\\WaveScope_artefacts\\Release\\Standalone\\WaveScope.exe

Build outputs:

• Standalone app: build\WaveScope_artefacts\Release\Standalone\WaveScope.exe
• Plug-ins: VST3

Linux

Prerequisites:

• cmake
• pkg-config
• libasound2-dev
• libjack-jackd2-dev
• libfreetype6-dev
• libfontconfig1-dev
• libx11-dev
• libxcomposite-dev
• libxcursor-dev
• libxext-dev
• libxinerama-dev
• libxrandr-dev
• libxrender-dev

Install and run:

git clone https://github.com/EyalDelarea/WaveScope.git
cd WaveScope
cmake -B build -DCMAKE_BUILD_TYPE=Release -DWAVESCOPE_COPY_AFTER_BUILD=OFF
cmake --build build --config Release
make run

Build outputs:

• Standalone app: build/WaveScope_artefacts/Release/Standalone/WaveScope
• Plug-ins: VST3

Need more detail?

• Full build, prerequisites, outputs, and DAW setup: docs/BUILD.md
• Contribution and release workflow: CONTRIBUTING.md
• Licensing notes: docs/LICENSING.md

What It Does

• Displays incoming audio as a vintage CRT-style oscilloscope
• Passes audio through unchanged
• Runs as a plug-in inside a DAW or as a standalone desktop app

Features

• Stereo overlay mode with dim right-channel trace and bright left-channel trace
• Channel modes: Stereo, Left, Right, Sum
• Freeze / hold with double-click
• Mouse-wheel zoom: 1X, 2X, 4X, 8X
• Bench-instrument inspired UI

Supported Targets

OS	Formats
macOS	AU, VST3, Standalone
Windows	VST3, Standalone
Linux	VST3, Standalone

Controls

• Click the display to cycle channel mode
• Double-click to freeze / unfreeze
• Use the mouse wheel to zoom vertically

Licensing

• Repo license: GPLv3
• Bundled font: SIL Open Font License
• Practical licensing notes: docs/LICENSING.md