macos-sounds

Reference macOS and iOS system sound file paths and afplay playback commands.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mshuffett/dotfiles --skill macos-sounds
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: macos-sounds
Source: https://github.com/mshuffett/dotfiles/tree/main/agents/knowledge/atoms/claude-skill-archive/macos-sounds
Command: npx skills add https://github.com/mshuffett/dotfiles --skill macos-sounds

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive reference for playing system sounds on macOS and iOS, enabling custom audio cues for notifications, alerts, and hooks.

Core Features & Use Cases

  • Sound Library: Access to classic macOS, modern iOS, and custom sound file paths.
  • Playback Utility: Use afplay command to play specified sound files.
  • Hook Integration: Configure sounds for specific events like 'Stop' or 'Notification' hooks.
  • Use Case: Set a distinct sound for when a long-running script finishes or fails, providing immediate auditory feedback.

Quick Start

Play the 'Glass.aiff' sound using the afplay command.

Frequently Asked Questions about macos-sounds

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I play macOS system sounds from the command line?▼

To play macOS system sounds from the command line, use the built-in `afplay` utility followed by the file path of the sound. This Skill provides a categorized reference of classic macOS and iOS audio file paths for immediate playback.

Can I trigger custom audio alerts when a script finishes on macOS?▼

Yes, you can trigger custom audio alerts when a script finishes by configuring hook configurations. This Skill enables setting distinct auditory feedback for specific events like 'Stop' or 'Notification' hooks using `afplay`.

What sound files are available for macOS and iOS notifications?▼

Available sound files for macOS and iOS notifications include classic macOS tones, modern iOS alert sounds, and custom sound file paths. This Skill acts as a comprehensive library reference for these system audio files.

Does the afplay utility require any dependencies to play audio?▼

The `afplay` utility does not require additional dependencies to play audio on macOS. This Skill operates with zero dependencies, relying solely on the native macOS command-line tool and system sound files.

What is the best way to add auditory feedback to long-running scripts?▼

The best way to add auditory feedback to long-running scripts is by calling `afplay` with a specific system sound path upon completion. This Skill provides the necessary sound file references and hook integration examples for this setup.