Back to guide
🚀 Getting Started

Installation

2026-01-10 · 3 min

Windows

Download the .exe file from the Download page, run it and follow the installation wizard. VoxWave automatically adds itself to startup.

  1. 1Go to the Download page and download the .exe
  2. 2Run the installer and follow the instructions
  3. 3VoxWave starts automatically and appears in the taskbar
💡

Windows Defender may show a warning because the application is not yet signed. Click 'More info' then 'Run anyway'.

Linux

Download the .AppImage file, install a few system dependencies, make it executable, then run it. Tested on Ubuntu 20.04+, Linux Mint, Fedora and Debian.

  1. 1Install the required system dependencies (see command below)
  2. 2Download the .AppImage from the Download page
  3. 3Make it executable with chmod +x
  4. 4Run it directly — VoxWave appears in the system tray
# Install dependencies (Ubuntu / Debian / Linux Mint)
sudo apt install libxcb-cursor0 xclip xdotool

# Download and run
chmod +x VoxWave-x86_64.AppImage
./VoxWave-x86_64.AppImage
⚠️

libxcb-cursor0 is required for the Qt interface. xclip and xdotool are required for clipboard-based text injection. Without them, VoxWave will show an error on startup.

To add VoxWave to your application menu, move the AppImage to a permanent location and create a desktop entry:

# Optional: add to application menu
mkdir -p ~/Applications
mv VoxWave-x86_64.AppImage ~/Applications/

# Create desktop entry
cat > ~/.local/share/applications/voxwave.desktop << 'EOF'
[Desktop Entry]
Name=VoxWave
Exec=$HOME/Applications/VoxWave-x86_64.AppImage
Icon=voxwave
Type=Application
Categories=Utility;Audio;
EOF
💡

The AppImage is fully self-contained — no installation needed. Just run it. The desktop entry is optional, for convenience only.

From source

Clone the repo, install dependencies with pip, then run VoxWave. Requires Python 3.11+.

git clone https://github.com/farnel94-source/voxwave-app.git
cd voxwave-app
pip install -r requirements.txt
python -m voxwave
⚠️

Building from source requires Python 3.11 or higher. Check your version with python --version.