Skip to content

docs: add libasound2-dev Linux prerequisite for Tauri build (fixes #872) #935

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
andreolf wants to merge 1 commit into
base: main
Choose a base branch
from
+18 −2
Open

docs: add libasound2-dev Linux prerequisite for Tauri build (fixes #872) #935

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -417,7 +417,7 @@ just dev # starts backend + desktop app

Install [just](https://github.com/casey/just): `brew install just` or `cargo install just`. Run `just --list` to see all commands.

**Prerequisites:** [Bun](https://bun.sh), [Rust](https://rustup.rs), [Python 3.11+](https://python.org), [Tauri Prerequisites](https://v2.tauri.app/start/prerequisites/), and [Xcode](https://developer.apple.com/xcode/) on macOS.
**Prerequisites:** [Bun](https://bun.sh), [Rust](https://rustup.rs), [Python 3.11+](https://python.org), [Tauri Prerequisites](https://v2.tauri.app/start/prerequisites/), and [Xcode](https://developer.apple.com/xcode/) on macOS. On Ubuntu/Debian Linux, also install `libasound2-dev` (`sudo apt-get install -y libasound2-dev`) before running `just setup` — the `alsa-sys` Rust crate requires it.

The repo ships a pre-wired `.mcp.json` at the root — running Claude Code inside this checkout picks up the Voicebox MCP tools automatically once the dev app is running.

Expand Down
18 changes: 17 additions & 1 deletion docs/content/docs/developer/setup.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -283,7 +283,23 @@ bun run tauri dev
- Check if port 17493 is available
</Accordion>

<Accordion title="Tauri build fails">
<Accordion title="Tauri build fails on Linux (alsa-sys / libasound not found)">
The `alsa-sys` crate requires the ALSA development headers, which are not installed by default on Ubuntu/Debian. Install them before running `just setup`:

```bash
sudo apt-get install -y libasound2-dev
```

On Fedora/RHEL:

```bash
sudo dnf install -y alsa-lib-devel
```

After installing, re-run `just setup` and `just dev`.
</Accordion>

<Accordion title="Tauri build fails (general)">
- Ensure Rust is installed: `rustc --version`
- Clean the build: `cd tauri/src-tauri && cargo clean`
- Try rebuilding: `just dev`
Expand Down