Skip to content

πŸ”Š Claude Code Audio Hooks v3.3.2 - WSL Audio Fix

Choose a tag to compare

@ChanMeng666 ChanMeng666 released this 06 Nov 23:16
· 118 commits to master since this release

πŸ”Š Claude Code Audio Hooks v3.3.2

πŸ› Bug Fix Release

This release fixes a critical audio playback issue for WSL (Windows Subsystem for Linux) users.

Fixed

  • WSL Audio Playback: Resolved issue where Windows MediaPlayer could not access audio files via WSL UNC paths (\\wsl.localhost\...)
    • Audio files are now copied to Windows temp directory before playback
    • Automatic cleanup after playback completes
    • Increased playback wait time from 3s to 4s for better reliability

Technical Details

Problem: Windows MediaPlayer cannot load MP3 files from WSL's UNC network paths.

Solution:

  • Copy audio file to C:/Windows/Temp before playing
  • Play from Windows-native path
  • Clean up temp file after playback in background process

Cross-Platform Status

  • βœ… WSL users: Audio now works correctly
  • βœ… macOS users: No changes (continues using afplay)
  • βœ… Linux users: No changes (continues using mpg123/aplay)
  • βœ… Git Bash users: No changes (already working)

Installation

git clone https://github.com/ChanMeng666/claude-code-audio-hooks.git
cd claude-code-audio-hooks
bash scripts/install-complete.sh

Upgrade from v3.3.0 or v3.3.1

cd claude-code-audio-hooks
git pull origin master
cp hooks/shared/hook_config.sh ~/.claude/hooks/shared/hook_config.sh

Full Changelog: v3.3.1...v3.3.2