Run Voicemod on Linux through CachyOS Proton. The installer fetches the latest CachyOS Proton release, downloads the latest Voicemod app from Voicemod's own servers, and wires it into PipeWire so your changed voice shows up as a normal microphone that Discord, OBS, games and browsers can use.
English | Português
This project is not affiliated with, endorsed by, or sponsored by Voicemod. It is a compatibility layer that runs the unmodified Windows application on Linux.
It does not crack, pirate, or bypass payment, login, or any copy protection. You use your own Voicemod account. No Voicemod or Proton binaries are distributed here: by default, the latest Voicemod app is downloaded from Voicemod's servers and CachyOS Proton from its official GitHub release, both into your home directory at install time.
Running Voicemod this way may still conflict with Voicemod's Terms of Use and could put an account at risk. Use it at your own discretion. See docs/LICENSES.md.
Nothing to clone. Run one of these:
# curl
curl -fsSL https://raw.githubusercontent.com/fakerh0g/voicemod-linux-port/main/install.sh | bash
# wget
wget -qO- https://raw.githubusercontent.com/fakerh0g/voicemod-linux-port/main/install.sh | bash
# npx (Node)
npx github:fakerh0g/voicemod-linux-portThe installer downloads a small bundle into a temporary directory, installs the
launcher and bridge into ~/.local/share/voicemod-linux, and removes the
temporary copy. It then downloads the latest CachyOS Proton and Voicemod
versions, verifying Proton's SHA-512 checksum. Start Voicemod from your
application menu or run voicemod-linux.
To use a local Windows installer instead of the latest Voicemod download, set
VOICEMOD_INSTALLER before running the installer:
export VOICEMOD_INSTALLER="$HOME/Downloads/VoicemodInstaller_1.6.24-m0ry5a.exe"
curl -fsSL https://raw.githubusercontent.com/fakerh0g/voicemod-linux-port/main/install.sh | bashThe executable is read from your machine and is never uploaded or included in the repository.
The installer checks for these and offers to install anything missing with your package manager (pacman, apt, dnf or zypper):
curlorwget,unzip,python3,tar,xzpactl(frompipewire-pulse/pulseaudio-utils)- a working PipeWire (or PulseAudio) sound server
The installer places the latest x86-64 CachyOS Proton release in this
application's data directory and verifies its SHA-512 checksum. It reuses that
download until a newer release is published. Optional: icoutils (for a nicer
menu icon).
- During onboarding, pick your real microphone and headphones. Do not choose "PulseAudio Input" or a "Monitor of ..." device as the microphone.
- In Discord, OBS or a game, select the input named Voicemod Virtual Audio Device (WDM).
- If a dialog offers to install the Voicemod driver, choose No. The real kernel driver cannot run under Wine, and that dialog closes the app.
See docs/TROUBLESHOOTING.md if something does not work.
voicemod-linux # start, or focus the running instance
voicemod-linux update # download the current Voicemod release
voicemod-linux install-app /path/to/VoicemodInstaller.exe
voicemod-linux kill # stop Voicemod and its wineserver
voicemod-linux doctor # print the detected setup
voicemod-linux logs # follow the Voicemod log
voicemod-linux setup-audio / teardown-audio
voicemod-linux winecfgcurl -fsSL https://raw.githubusercontent.com/fakerh0g/voicemod-linux-port/main/uninstall.sh | bashThis removes ~/.local/share/voicemod-linux, the launcher symlink, the menu
entry and the voicemod: handler. Your Voicemod account and any Steam
CachyOS Proton installation are left untouched.
- Manjaro and Arch Linux, kernel 6.18
- GNOME on Wayland
- PipeWire 1.6 (with
pipewire-pulse) - CachyOS Proton (latest x86-64 release)
- x86-64 with AVX, NVIDIA GPU (DXVK)
It should work on other distributions and desktops with PipeWire. Reports and fixes for KDE Plasma, X11, PulseAudio-only setups, AMD/Intel GPUs and other configurations are welcome. See CONTRIBUTING.md.
Voicemod.exe is a Qt 6 program: the UI is a Vue bundle rendered by
QtWebEngine, and audio runs in a native PortAudio/WASAPI engine that, on
Windows, talks to a kernel driver (voicemodvad.sys) exposing a virtual
microphone and speaker plus a control device at \\.\voicemodvad.
Wine cannot run that kernel driver, so each Windows-only piece is replaced:
| Windows | Linux replacement |
|---|---|
voicemodvad.sys render/capture endpoints |
PipeWire null sink voicemod_vad and remap source voicemod_mic, both named "Voicemod Virtual Audio Device (WDM)" |
\\.\voicemodvad control device |
bridge/vadshim, built as avrt.dll and loaded from the app folder |
| Driver entry seen by SetupAPI after login | bridge/registry/voicemodvad.reg |
| D3D11 texture sharing for QtWebEngine | DXVK and the Wine in CachyOS Proton (stock Wine may show a black window) |
Browser login and the voicemod: callback |
bin/voicemod-open-url plus a .desktop handler |
The application binary on disk is never modified. The shim loads as avrt.dll
through WINEDLLOVERRIDES=avrt=n,b, answers \\.\voicemodvad by patching the
running process's imports, and patches IAudioSessionManager2 (which Wine
stubs out) so device setup succeeds. See bridge/vadshim/vadshim.c for details.
The audio bridge is adapted from the MIT-licensed
brunos3d/voicemod-linux; see
NOTICE for attribution.
The release bundle ships a prebuilt shim. To build it yourself you need
clang, lld and the Wine development headers:
git clone https://github.com/fakerh0g/voicemod-linux-port
cd voicemod-linux-port
make -C bridge/vadshim # produces bridge/vadshim/avrt.dll
./install.sh --local # install from this checkoutThe build is reproducible (lld-link /Brepro); CI verifies this on every
change. See CONTRIBUTING.md.
- A few voice presets fail to load with
Error during string conversion ... to floatinside the closed-source audio SDK. Most voices work. Cause unknown; it is not a locale issue. - The app cannot set the virtual device as the system default or hide it
(
IPolicyConfigis not in Wine). Select the device in each application. - Per-device peak meters and the "connected apps" indicator stay empty.
voicemod-linux updatedownloads the latest app from Voicemod; to install a particular local installer, usevoicemod-linux install-app /path/to/file.exe.
This project's own code is MIT (see LICENSE). Third-party components and the legal basis are described in NOTICE and docs/LICENSES.md.