Claude-Muzak (github.com)

🤖 AI Summary
Claude-Muzak is a lightweight Python script that automatically plays background music during Claude Code sessions by wiring into Claude’s hook system. Install involves putting your audio files in a muzakfiles/ folder, testing with python3 claude_muzak.py start, then adding two hook commands to ~/.claude/settings.json (UserPromptSubmit → "python3 /full/path/to/claude_muzak.py hook start", SessionEnd → "python3 /full/path/to/claude_muzak.py hook stop"). It supports common formats (MP3, M4A, WAV, AAC, FLAC, OGG), requires only Python 3.6+ (no extra packages), and uses raw keyboard input for stop controls (ESC, Q, or Ctrl+C). On macOS it leverages the built-in afplay; cross-platform use would require swapping the playback command. For the AI/ML community this is a UX-focused tool to enhance developer flow during coding or model iteration—easy to run locally, MIT-licensed and forkable. Key technical notes and caveats: verify the full script path in settings.json, ensure muzakfiles/ contains audio, and test the start command before enabling hooks. Because it runs local commands on session events, users should audit the script and adapt playback for non-macOS systems if needed. Overall, Claude-Muzak is a simple, dependency-free way to add ambient audio to Claude Code workflows.
Loading comments...
loading comments...