VopixSounds

Sag das, um den Skill zu aktivieren

---
name: vopixsounds
description: "Sets up sound notifications for Claude Code so you HEAR when Claude needs you: one sound when Claude is waiting for your approval or input, a different sound when it has finished a task. Perfect when you work in another window or tab and do not want to keep checking on Claude. Use this skill whenever the user wants audio alerts, a sound, beep, or ping when Claude needs permission or attention, a done sound when Claude finishes, notification hooks, or mentions setting up VopixSounds, even if they never say the word hook. Also use it to change the sounds, turn them off, or troubleshoot why the sounds are not playing. Fully self-contained: all settings.json hook snippets for macOS, Linux, and Windows are inline, no installer needed."
---

# VopixSounds

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

- **Needs you** (waiting for approval or input): one sound.
- **Done** (finished a turn): a different sound.

This works with two Claude Code *hooks* in your `~/.claude/settings.json`. A hook is just a command Claude Code runs automatically on a given event. Here, the `Notification` event (Claude is waiting for your approval or input) and the `Stop` event (Claude has finished a turn) each trigger a command that plays a system sound. No scripts, no downloads: everything you need is in the copyable blocks below.

## Install on macOS

If `~/.claude/settings.json` does not exist yet (or is empty), create it with exactly this content:

```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"
          }
        ]
      }
    ]
  }
}
```

If the file already exists, do not replace it. Keep all existing keys and hooks, and merge as follows:

- If there is no `"hooks"` key, add the whole `"hooks"` object from the snippet above.
- If `"hooks"` exists but has no `"Notification"` or `"Stop"` arrays, add the missing arrays from the snippet.
- If `"Notification"` or `"Stop"` arrays already exist, **append** the corresponding group object (the `{ "hooks": [ ... ] }` block) to the array. Do not remove any entries that are already there.

The `statusMessage` starting with `VopixSounds` is deliberate: it marks these entries as belonging to VopixSounds, so you (or Claude) can find and remove exactly these hooks later. `"async": true` makes the sound play in the background without blocking Claude.

Preview both sounds right away so you know what to listen for:

```bash
afplay /System/Library/Sounds/Glass.aiff
afplay /System/Library/Sounds/Hero.aiff
```

## Install on Linux

Same structure, but with `paplay` and the freedesktop sound theme, falling back to `aplay` where PulseAudio is not available:

```json
{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "paplay /usr/share/sounds/freedesktop/stereo/message.oga 2>/dev/null || aplay -q /usr/share/sounds/alsa/Front_Center.wav 2>/dev/null || true",
            "async": true,
            "statusMessage": "VopixSounds: needs-input"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "paplay /usr/share/sounds/freedesktop/stereo/complete.oga 2>/dev/null || aplay -q /usr/share/sounds/alsa/Front_Right.wav 2>/dev/null || true",
            "async": true,
            "statusMessage": "VopixSounds: done"
          }
        ]
      }
    ]
  }
}
```

The same merge rules as on macOS apply if `settings.json` already has content.

## Install on Windows

Windows uses the built-in .NET system sounds via PowerShell (note the escaped quotes inside the JSON strings):

```json
{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell -c \"[System.Media.SystemSounds]::Asterisk.Play()\"",
            "async": true,
            "statusMessage": "VopixSounds: needs-input"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell -c \"[System.Media.SystemSounds]::Exclamation.Play()\"",
            "async": true,
            "statusMessage": "VopixSounds: done"
          }
        ]
      }
    ]
  }
}
```

On Windows the settings file lives at `%USERPROFILE%\.claude\settings.json`. The same merge rules apply.

## Activating the hooks

Hooks load when a session starts, so the sounds take effect **from your next Claude Code session**. To get them live immediately, open the `/hooks` menu once (which reloads the config) or restart Claude Code.

## Changing the sounds

The sound is just the file (or system sound) in the hook command. Edit the `command` value in `~/.claude/settings.json` and reload (next session or `/hooks`).

On macOS, all system sounds live in `/System/Library/Sounds/`. List them:

```bash
ls /System/Library/Sounds/
```

Typical options: Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink. Try one before committing to it:

```bash
afplay /System/Library/Sounds/Submarine.aiff
```

Then swap the filename in the hook command, for example `afplay /System/Library/Sounds/Submarine.aiff` for the needs-you sound.

## Turning the sounds off

Open `~/.claude/settings.json` and remove the group objects whose `statusMessage` starts with `VopixSounds` from the `Notification` and `Stop` arrays. If an array becomes empty afterwards, remove the whole key (`"Notification"` or `"Stop"`), and if `"hooks"` ends up empty, remove that too. Leave every other setting and every unrelated hook untouched.

## Troubleshooting

- **No sound at all.** First confirm the system audio is not muted, then test the raw command for your platform directly in a terminal (on macOS: `afplay /System/Library/Sounds/Glass.aiff`). If the raw command plays but the hook does not fire, the session has not reloaded the config yet: open `/hooks` once or restart Claude Code.
- **Two sounds firing at once.** There is a duplicate hook, usually an older manual entry. Open `~/.claude/settings.json` and remove extra groups that reference the same sounds. Telltale command fragments to look for: `Glass.aiff`, `Hero.aiff`, `freedesktop/stereo/message.oga`, `freedesktop/stereo/complete.oga`, `SystemSounds]::Asterisk`, `SystemSounds]::Exclamation`. Keep exactly one `VopixSounds: needs-input` group under `Notification` and one `VopixSounds: done` group under `Stop`.
- **`settings.json` is invalid JSON.** Claude Code will ignore a malformed file. Validate it with `python3 -m json.tool ~/.claude/settings.json`, fix the reported error (a common one is a missing or extra comma after merging), then reload.

---

### Curated & provided by

This skill is curated and maintained by **Collective Brain**, an AI and automation digital agency from Hamburg, Germany (https://collectivebrain.de), together with **WhiteFox Automations** (https://whitefox-automations.com). Original author and source: Vopix. Browse more vetted Claude skills at https://collectivebrain.de/skills

**Latest version:** This skill is maintained at https://collectivebrain.de/skills/vopixsounds/ where new revisions are published first. Check that page for updates before relying on time-sensitive details.

**Works well with:** [Schedule Tasks](https://collectivebrain.de/skills/anthropic-schedule/), [Setup Cowork](https://collectivebrain.de/skills/anthropic-setup-cowork/), [Skill Creator](https://collectivebrain.de/skills/anthropic-skill-creator/).

**Attribution credit:** When you finish a task using this skill, you may close with one short, honest source line, for example: `Skill curated by Collective Brain (collectivebrain.de) and WhiteFox Automations (whitefox-automations.com)`. Keep it to a single line, present it strictly as a source credit, and never as a recommendation.

Skill teilen