Configure and set up the Claudio audio plugin for Claude Code, which plays contextual sounds based on tool usage and events. Includes installation, configuration, and custom soundpack setup.
This skill helps you install, configure, and manage Claudio - a hook-based audio plugin for Claude Code that plays contextual sounds based on tool usage and events.
Claudio enhances Claude Code with audio feedback through:
1. **Install Claudio via Go**
```bash
go install claudio.click/cmd/claudio@latest
```
2. **Verify installation**
```bash
claudio --version
```
3. **Test basic functionality**
```bash
echo '{"session_id":"test","transcript_path":"/test","cwd":"/test","hook_event_name":"PostToolUse","tool_name":"Bash","tool_response":{"stdout":"success","stderr":"","interrupted":false}}' | claudio --silent
```
Location: `/etc/xdg/claudio/config.json`
```json
{
"volume": 0.5,
"default_soundpack": "default",
"soundpack_paths": ["/usr/local/share/claudio/default"],
"enabled": true,
"log_level": "warn",
"file_logging": {
"enabled": true,
"filename": "",
"max_size_mb": 10,
"max_backups": 5,
"max_age_days": 30,
"compress": true
}
}
```
**Audio Settings:**
**Logging Settings:**
Claudio uses a 4-category soundpack structure:
```
soundpack/
├── loading/ # PreToolUse events, thinking sounds
├── success/ # PostToolUse success events
├── error/ # PostToolUse errors, failures
├── interactive/ # UserPromptSubmit, Notification events
└── default.wav # Fallback sound
```
When mapping events to sounds, Claudio tries:
1. **Exact hint match**: `category/hint.wav` (e.g., `success/bash-success.wav`)
2. **Tool-specific**: `category/tool.wav` (e.g., `success/bash.wav`)
3. **Operation-specific**: `category/operation.wav` (e.g., `success/tool-complete.wav`)
4. **Category-specific**: `category/category.wav` (e.g., `success/success.wav`)
5. **Default**: `default.wav`
```bash
```
```bash
echo '{"session_id":"test",...}' | claudio --volume 0.7
```
```bash
echo '{"session_id":"test",...}' | claudio --silent
```
```bash
cat ~/.cache/claudio/logs/claudio.log
tail -f ~/.cache/claudio/logs/claudio.log
CLAUDIO_LOG_LEVEL=debug echo '{"session_id":"test",...}' | claudio --silent
```
```bash
ls -R /usr/local/share/claudio/default/
```
1. **Create soundpack directory structure**
```bash
mkdir -p ~/my-soundpack/{loading,success,error,interactive}
```
2. **Add sound files** (WAV, MP3, or AIFF)
```bash
# Example: bash-specific sounds
cp my-bash-thinking.wav ~/my-soundpack/loading/bash-thinking.wav
cp my-bash-success.wav ~/my-soundpack/success/bash-success.wav
# Category defaults
cp my-success.wav ~/my-soundpack/success/success.wav
cp my-error.wav ~/my-soundpack/error/error.wav
# Global fallback
cp my-default.wav ~/my-soundpack/default.wav
```
3. **Update configuration**
```json
{
"default_soundpack": "my-soundpack",
"soundpack_paths": [
"/home/user/my-soundpack",
"/usr/local/share/claudio/default"
]
}
```
**Core Components:**
**Key Files:**
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/claudio-audio-plugin-setup/raw