Unable to load custom sound pack

[joshwand]

I followed the configuration instructions as closely as I could, but it never finds my custom sound pack:

// config.json

{...
  "default_soundpack": "custom",
  "soundpack_paths": ["/Users/joshwand/.local/share/claudio/custom.json"],
  "enabled": true,
  "log_level": "debug",
...
}

~/.local/share/claudio $ ll
total 24
-rw-r--r--@ 1 joshwand  staff   3.8K Oct 27 15:13 custom.json

// /Users/joshwand/.local/share/claudio/custom.json
{
  "name": "custom",  
  "description": "my custom set",
  "version": "1.0.0",
  "mappings" {
...

time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="creating new XDG directory manager"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="generated soundpack paths" soundpack_id=custom total_paths=3 user_path="/Users/joshwand/Library/Application Support/claudio/soundpacks/custom" system_paths=2
time=2025-10-29T15:14:59.591-07:00 level=INFO msg="configured soundpack not found, will try platform fallback" soundpack=custom error="stat custom: no such file or directory"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="creating soundpack mapper with base paths" name=custom primary_path=custom base_paths="[/Users/joshwand/Library/Application Support/claudio/soundpacks/custom /Library/Application Support/claudio/soundpacks/custom /Users/joshwand/.local/share/claudio/soundpacks/custom /Users/joshwand/.local/share/claudio/custom.json]"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="creating soundpack mapper" name=custom path=custom
time=2025-10-29T15:14:59.591-07:00 level=ERROR msg="soundpack path does not exist" path=custom error="stat custom: no such file or directory"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="primary path failed, falling back to base paths" primary_path=custom primary_error="soundpack path does not exist: stat custom: no such file or directory" base_paths_count=4
time=2025-10-29T15:14:59.591-07:00 level=INFO msg="creating directory mapper with base paths" name=custom base_paths="[/Users/joshwand/Library/Application Support/claudio/soundpacks/custom /Library/Application Support/claudio/soundpacks/custom /Users/joshwand/.local/share/claudio/soundpacks/custom /Users/joshwand/.local/share/claudio/custom.json]"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="creating directory mapper" name=custom base_paths="[/Users/joshwand/Library/Application Support/claudio/soundpacks/custom /Library/Application Support/claudio/soundpacks/custom /Users/joshwand/.local/share/claudio/soundpacks/custom /Users/joshwand/.local/share/claudio/custom.json]" base_paths_count=4
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="configured soundpack unavailable, trying platform JSON fallback" soundpack=custom
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="creating new config manager"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="creating new XDG directory manager"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="executable directory detected for platform detection" executable=/Users/joshwand/go/bin/claudio directory=/Users/joshwand/go/bin
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="failed to read /proc/version" error="open /proc/version: no such file or directory"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="checking WSL detection" proc_version_snippet="" wsl_env=""
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="no WSL indicators found"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="detecting platform soundpack with enhanced detection" executable_dir=/Users/joshwand/go/bin is_wsl=false runtime_goos=darwin
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="failed to read /proc/version" error="open /proc/version: no such file or directory"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="checking WSL detection" proc_version_snippet="" wsl_env=""
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="no WSL indicators found"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="platform file not found" path=/Users/joshwand/go/bin/darwin.json
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="failed to read /proc/version" error="open /proc/version: no such file or directory"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="checking WSL detection" proc_version_snippet="" wsl_env=""
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="no WSL indicators found"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="failed to read /proc/version" error="open /proc/version: no such file or directory"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="checking WSL detection" proc_version_snippet="" wsl_env=""
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="no WSL indicators found"
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="using embedded platform soundpack" platform_file=darwin.json is_wsl=false runtime_goos=darwin
time=2025-10-29T15:14:59.591-07:00 level=INFO msg="using platform-specific soundpack" path=embedded:darwin.json
time=2025-10-29T15:14:59.591-07:00 level=DEBUG msg="loading embedded platform soundpack" filename=darwin.json

$ claudio --version
claudio version 1.11.0 (Version 1.11.0)

[jzellis]

Having the same issue, I just coped the startrek-bridge directories to ~/.local/share/claudio and pointed my config.json at it and it gives me the same level=ERROR msg="soundpack path does not exist" path=startrek-bridge error="stat startrek-bridge: no such file or directory" error.

claudio --version
claudio version 1.11.1 (Version 1.11.1)

[xrstf]

I am currently debugging the same issue. It's weird that claudio soundpack list has no problems finding and listing all soundpacks, and claudio soundpack use allows me to switch to one, but then Claudio fails to load it.

I have tried so many different combinations of soundpack (with a JSON file, with a JSON file plus .json extension, different names, explicit soundpaths, ...).

Ultimately I kind of gave up on the idea of having multiple soundpacks and configured

{
  "default_soundpack": "/home/xrstf/.local/share/claudio/soundpacks/startrek-bridge-mp3.json",
}

(Using the JSON file is important to map from Claudio's expected .wav files to .mp3 – remember to adjust the paths in the file (not sure if relative paths are supported)).