Claude Sound Fx

English | 中文 | 日本語

You kick off a task, switch to your browser, and forget about the terminal. Five minutes later you check back — it's been waiting for you the whole time.

Sound FX adds themed audio cues to Claude Code and Opencode so you never have to babysit the terminal again. Hear when a task finishes, when something breaks, or when the AI needs your input — even while you're in another window.

Pick a single theme or go Mix mode and let 12 themes collide randomly. JARVIS confirms your deploy. GLaDOS mocks your errors. Pikachu celebrates your tests passing. A WoW Peon reluctantly obeys your commands.

https://github.com/user-attachments/assets/c47537fc-1c18-4256-877d-0f22d4314bfd

---

Platform Support

Works on every major platform. No extra setup needed for local use.

Platform	Extra setup?	How it works
macOS	No	Plays via afplay directly
Windows (WSL)	No	Auto-calls powershell.exe or ffplay.exe via WSL interop
Linux desktop	No	Auto-detects paplay / ffplay / aplay
Remote server (SSH)	Yes	Requires a relay script on your local machine — see below

Remote server setup

When running on a headless server with no audio hardware, sounds are forwarded to your local machine via a lightweight HTTP relay:

# ① Clone the repo on your LOCAL machine
git clone https://github.com/6m1w/claude-sound-fx.git

# ② Start the relay (runs in background, listens on port 19876)
python3 claude-sound-fx/scripts/relay.py &

# ③ SSH into the remote server with port forwarding
ssh -R 19876:127.0.0.1:19876 your-server

# ④ On the server, use Claude Code / Opencode as usual — sounds play locally

Relay commands:

python3 scripts/relay.py --status  # Show config and loaded themes
python3 scripts/relay.py --kill    # Stop the relay

---

Install

Claude Code

/plugin marketplace add 6m1w/claude-sound-fx
/plugin install sound-fx@claude-sound-fx

Then configure your theme:

/sound-fx:setup

The setup wizard will walk you through theme selection and trigger mode.

Opencode

npm install @6m1w/opencode-sound-fx

Add to opencode.json:

{
  "plugin": ["@6m1w/opencode-sound-fx"]
}

Shares the same config file (~/.claude/sound-fx.local.json) and audio themes.

Update or Remove

Run the same command anytime:

/sound-fx:setup

The wizard will ask you to Configure, Update, or Remove:

Action	What it does
Configure	Set up or change your theme and trigger mode
Update	Re-apply current settings, refresh hooks, and play a test sound
Remove	Completely remove sound effects — deletes config file

---

Themes

Sci-Fi & AI

Theme	Vibe	Origin
Jarvis	"At your service, sir." — Calm, competent, slightly British.	Iron Man
GLaDOS	"This was a triumph." — Passive-aggressive AI with dark humor.	Portal
Star Trek	Classic starship interface chirps, beeps, and red alerts.	Star Trek
Optimus Prime	"Autobots, roll out." — Heroic commander energy.	Transformers

Anime