Skip to content

VoiceProcessor 1.0.0

Choose a tag to compare

@jmarasch jmarasch released this 01 Aug 05:27
· 8 commits to main since this release

Routes an audio file through a Voicemod voice filter and saves the result as MP3, WAV, Ogg Vorbis, Opus, FLAC, or AAC.

Download VoiceProcessor-1.0.0-win-x64.zip, unzip anywhere, run VoiceProcessor.exe. Self-contained — no .NET install needed. Read QUICKSTART.txt first; the one-time setup is two settings inside Voicemod.

Requirements

  • Windows
  • Voicemod desktop app running on the same machine (its Control API is localhost-only)
  • A Voicemod Control API client key
  • VB-Audio Virtual Cable — free, 2 MB, not optional
  • ffmpeg — optional, only for Ogg / Opus / FLAC / AAC

Why the virtual cable is required

The Voicemod Control API carries no audio. It is a remote control for the desktop app — the full action list is voice selection, toggles, and soundboards, with no method that accepts, returns, or streams audio. Voicemod itself is a real-time effect on a live microphone signal with no file input.

So the only way to get a file through a filter is to feed it in as if it were a microphone. The cable does that. This is also why processing runs in real time — a ten-minute file takes ten minutes. It is a live capture, not a conversion.

What's in it

  • VoiceProcessor.exe — the desktop app. Connects on launch, live capture-level meter, exact progress.
  • voiceproc.exe — CLI for diagnosis. devices --all inspects the machine and says which device goes where.

Output formats are pluggable: one class implementing IAudioEncoder, one registration, and it appears in both front ends.

Verified

Real end-to-end render on Windows 11 with VB-Cable and Voicemod 3.16.70: Control API handshake, 249-filter enumeration, filter selection, real-time capture, MP3 encode, and the WPF app.

Not yet exercised

  • Ogg / Opus / FLAC / AAC output — the ffmpeg encoder is written but has not been run
  • Latency calibration is manual; see the calibration section in docs/audio-routing.md
  • Long files and dropout behaviour under load