4.5 Installing Omnivox From Source ¶

Use this route on GNU/Linux and macOS. It requires network access for the initial clone, Rust toolchain, and locked dependency downloads.

Install these prerequisite classes before building:

• rustup; the checked-in rust-toolchain.toml selects the supported Rust release.
• Python 3, a C and C++ toolchain, CMake, and Clang with libclang. The supported build wrapper uses these to build and stage eSpeak NG and its generated data.
• On GNU/Linux, pkg-config and ALSA development headers. The ALSA package is commonly named libasound2-dev on Debian or Ubuntu and alsa-lib-devel on Fedora.
• On macOS, the Xcode command-line tools. Install them with xcode-select --install if they are absent.

Keep the two repositories beside one another; this also matches the WSL2 release layout:

cd /path/containing/emacsvox
git clone https://github.com/bartbunting/omnivox
cd omnivox
make build
make install

make build performs the locked release build and stages the matching eSpeak data and third-party notices. make install installs the binary and those adjacent directories, normally below ~/.cargo/bin. Set OMNIVOX_INSTALL_BIN before make install only when the Cargo binary directory is elsewhere. Do not use a bare cargo build as the installation procedure; it does not create the complete staged payload.

Make the install directory visible on PATH before continuing. No proprietary speech runtime is needed for the recommended Linux or macOS path.