VopixSounds

Say this to activate the skill

---
name: vopixsounds
description: Adds sound notifications to Claude Code so you HEAR when it needs you. One sound when Claude waits for your approval or input, a different sound when a task finishes. Triggers on "play a sound when Claude is done", "notify me with a beep", "audio alert", "notification hook", "install VopixSounds".
---

# VopixSounds

Gives Claude Code an audible heads-up so you never miss when it needs you:

- **Braucht dich** (wartet auf Freigabe oder Eingabe) -> ein Sound.
- **Fertig** (Turn beendet) -> ein anderer Sound.

Das laeuft ueber zwei *Hooks* in `~/.claude/settings.json`. Ein Hook ist ein
Befehl, den Claude Code bei einem Ereignis automatisch ausfuehrt, hier ein Befehl,
der einen System-Sound abspielt.

## Einrichten

Bearbeite `~/.claude/settings.json` und fuege die beiden Hooks hinzu (vorhandene
Settings und Hooks bleiben erhalten, nichts wird ueberschrieben). Lege `hooks`
an, falls es noch nicht existiert:

```json
{
  "hooks": {
    "Notification": [
      { "hooks": [ { "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff", "async": true, "statusMessage": "VopixSounds: needs-input" } ] }
    ],
    "Stop": [
      { "hooks": [ { "type": "command", "command": "afplay /System/Library/Sounds/Hero.aiff", "async": true, "statusMessage": "VopixSounds: done" } ] }
    ]
  }
}
```

Setze `afplay /System/Library/Sounds/Glass.aiff` und `afplay /System/Library/Sounds/Hero.aiff` je nach Betriebssystem ein:

- **macOS:** `afplay /System/Library/Sounds/Glass.aiff` (needs-you) und `afplay /System/Library/Sounds/Hero.aiff` (done). Weitere Sounds in `/System/Library/Sounds/`.
- **Linux:** `paplay /usr/share/sounds/freedesktop/stereo/message.oga` und `paplay /usr/share/sounds/freedesktop/stereo/complete.oga`.
- **Windows:** `powershell -c (New-Object Media.SoundPlayer).PlaySync()` bzw. `[System.Media.SystemSounds]::Asterisk.Play()` und `::Exclamation.Play()`.

Das Einsetzen ist idempotent: Sind die beiden VopixSounds-Hooks schon da, nicht
erneut anlegen, nur den Befehl abgleichen, damit keine Sounds doppelt feuern.

## Aktivieren

Hooks werden beim Start einer Session geladen. Die Sounds greifen ab der
**naechsten Claude-Code-Session**. Sofort live in der aktuellen Session: einmal
das `/hooks`-Menue oeffnen (laedt die Config neu) oder Claude Code neu starten.

## Sounds aendern oder abschalten

Sound aendern = die Datei im `command` tauschen. Abschalten = die beiden
VopixSounds-Hooks aus `settings.json` entfernen, der Rest bleibt unberuehrt.

## Troubleshooting

- **Kein Ton:** Pruefen, ob Audio stumm ist, dann den rohen Befehl direkt testen (macOS: `afplay /System/Library/Sounds/Glass.aiff`). Klappt der Befehl, aber der Hook feuert nicht, hat die Session die Config noch nicht neu geladen -> `/hooks` oeffnen oder neu starten.
- **Zwei Sounds:** Ein aelterer/manueller Hook ist noch vorhanden. Doppelten Eintrag entfernen.

Share this skill