Skip to content

Installation

OpenVoxTuner is a real-time pitch correction & harmony generation plugin for vocals, available as VST3, AU, and a Standalone application, built with JUCE 8 (C++17) and licensed under AGPLv3.

This page explains how to install OpenVoxTuner on Windows and macOS, either with the official installers or by installing plugin files manually.

System requirements

Windows macOS
OS Windows 10 / 11 (64-bit) macOS 11.0 (Big Sur) or later
Architecture x64 Universal (arm64 + x86_64)
Formats VST3, Standalone VST3, AU, Standalone
ARA2 ✅ ✅

Official installers

OpenVoxTuner is distributed as GitHub Releases for each version:

Platform Artifact Notes
Windows OpenVoxTuner_Windows_Installer.exe Installer (Inno Setup)
macOS OpenVoxTuner-macOS.zip Drag-and-drop: VST3 + Standalone (universal arm64/x86_64) — not notarized
macOS OpenVoxTuner-macOS.pkg Signed & notarized installer: VST3 → /Library/Audio/Plug-Ins/VST3, AU → /Library/Audio/Plug-Ins/Components, Standalone → /Applications

macOS signing status

The .pkg installer is signed and notarized and includes VST3, AU and Standalone. The drag-and-drop .zip is not notarized — if Gatekeeper blocks its contents, right-click (Control-click) and choose Open, or use the .pkg installer.

Windows installation

  1. Download OpenVoxTuner_Windows_Installer.exe from the latest GitHub Release.
  2. Run the installer. It copies:
  3. the VST3 plugin to C:\Program Files\Common Files\VST3\
  4. the Standalone application to C:\Program Files\OpenVoxTuner\
  5. The installer also handles uninstallation cleanly.

SmartScreen

Because the installer is not code-signed, Windows SmartScreen may show a blue warning ("Windows protected your PC"). Click More info → Run anyway to proceed.

Option 2 — Manual copy

If you built the plugin yourself or received the .vst3 / .clap files, copy them to the system-wide plugin folders:

# VST3
Copy-Item .\OpenVoxTuner.vst3 "C:\Program Files\Common Files\VST3\" -Recurse

# CLAP (if a CLAP build is available)
Copy-Item .\OpenVoxTuner.clap "C:\Program Files\Common Files\CLAP\"

Rescan your DAW

After copying, restart your DAW or trigger a plugin rescan so the newly added plugin is discovered.

macOS installation

Option 1 — Drag-and-drop .zip

  1. Download OpenVoxTuner-macOS.zip.
  2. Unzip it and drag OpenVoxTuner.vst3 to ~/Library/Audio/Plug-Ins/VST3/.
  3. Drag the OpenVoxTuner.app (Standalone) to your Applications folder.
# Manual equivalent
mkdir -p ~/Library/Audio/Plug-Ins/VST3
rsync -a --delete ~/Downloads/OpenVoxTuner.vst3 ~/Library/Audio/Plug-Ins/VST3/

Option 2 — .pkg installer

  1. Download OpenVoxTuner-macOS.pkg.
  2. Double-click the package and follow the installer, or run:
sudo installer -pkg OpenVoxTuner-macOS.pkg -target /

This installs: - VST3 → /Library/Audio/Plug-Ins/VST3/OpenVoxTuner.vst3 - AU → /Library/Audio/Plug-Ins/Components/OpenVoxTuner.component - Standalone → /Applications/OpenVoxTuner.app

Building the AU (from source)

The AU ships in the official .pkg installer. Developers can still build it from source (for development or testing):

  1. Build the AU with ./scripts/build_macos_au.sh --juce-path ~/dev/JUCE --install.
  2. The component installs to ~/Library/Audio/Plug-Ins/Components/OpenVoxTuner.component.
  3. On Apple Silicon, ad-hoc sign the locally built component (satisfies the code-signing requirement; the build may already be ad-hoc signed — run this to be sure):
codesign --force --deep -s - ~/Library/Audio/Plug-Ins/Components/OpenVoxTuner.component
  1. If Gatekeeper blocks it, remove the quarantine attribute:
sudo xattr -rd com.apple.quarantine ~/Library/Audio/Plug-Ins/Components/OpenVoxTuner.component
  1. Restart your DAW and rescan the plugin (in Logic: Plug-in Manager → Reset & Rescan).

Standalone application

The Standalone version runs OpenVoxTuner as a desktop application without a DAW. It includes an internal 120 BPM transport and is useful for quick previews and testing.

  • Windows: C:\Program Files\OpenVoxTuner\OpenVoxTuner.exe
  • macOS: /Applications/OpenVoxTuner.app

Loading in a DAW

  1. After installing, restart your DAW.
  2. Add OpenVoxTuner to a vocal track (or any audio track).
  3. On macOS, if the plugin was quarantined and the DAW silently fails to load it, clear the quarantine attribute (see above) and rescan.
  4. In DAWs that support it, ARA2 integration provides seamless timeline integration; otherwise the plugin reads key/scale from the audio input (auto or via the OpenVoxKey companion plugin on a sidechain bus).

OpenVoxKey companion plugin

OpenVoxTuner ships with a companion OpenVoxKey plugin (VST3/AU) that you place on an accompaniment track. It detects the musical key/scale and publishes it to the main instance via shared memory IPC — set Key Source to Companion on OpenVoxTuner to use it.

Uninstalling

  • Windows: use the Inno Setup installer's uninstall entry (Add or Remove Programs).
  • macOS: 
    rm -rf "/Library/Audio/Plug-Ins/VST3/OpenVoxTuner.vst3"
rm -rf "~/Library/Audio/Plug-Ins/Components/OpenVoxTuner.component"
rm -rf /Applications/OpenVoxTuner.app

Where to go next

  • Build Guide — build OpenVoxTuner from source on Windows and macOS.
  • Testing — how the unit test suite works.
  • Contributing — how you can help the project.