{
  "markdown": "# Claude Sounds Plugin\n\nPlay audio on Claude Code events — task done, input needed, tool calls, errors. Supports themes, per-project config, and a built-in graphical Web UI.\n\n让 Claude Code 在关键事件时播放提示音，支持主题切换、项目级配置和图形化管理界面。\n\n## Screenshots / 界面预览\n\n![Status](assets/index.png)\n\n![Themes](assets/themes.png)\n\n![Store](assets/shop.png)\n\n## Features / 功能\n\n- Plays sounds on Stop, Notification, Error, Permission, and PermissionRequest events\n- Graphical Web UI for visual management (no command line required)\n- Theme support — built-in default theme, install more from the store\n- Per-project theme and hook overrides\n- Cross-platform: macOS / Linux / Windows\n- Zero external dependencies (pure Shell + Python 3 stdlib)\n\n## Supported Events / 支持的事件\n\n| Event | Trigger | Default |\n|-------|---------|---------|\n| Stop | Task completed | ✅ On |\n| Notification | Input needed | ✅ On |\n| Error | Error occurred | ✅ On |\n| Permission | Before every tool call | ❌ Off |\n| PermissionRequest | When permission dialog appears (v2.0.45+) | ✅ On |\n\n## Installation / 安装\n\n```bash\ngit clone https://github.com/0xbaiqi/claude-sounds-plugin\ncd claude-sounds-plugin\nbash install.sh\n```\n\nRestart Claude Code to activate. / 重启 Claude Code 生效。\n\n## Usage / 使用\n\n### Graphical UI (recommended) / 图形界面（推荐）\n\n```\n/sounds:cs ui\n```\n\nOpens a browser-based dashboard to:  \n在浏览器中可视化管理：\n\n- Toggle the plugin and individual hooks / 开关插件和各个 Hook\n- Browse, preview, and switch themes / 浏览、试听、切换主题\n- Install themes from the store / 从商店安装主题\n- Install local `.cstheme` files / 安装本地 `.cstheme` 文件\n- Configure per-project theme and hooks / 按项目配置主题和 Hook\n\n### Command Line / 命令行\n\n```\n/sounds:cs               Show current config / 查看当前配置\n/sounds:cs help          Full command reference / 查看完整帮助\n```\n\n#### Basic control / 基本控制\n\n```\n/sounds:cs enable        Enable plugin / 启用插件\n/sounds:cs disable       Disable plugin / 禁用插件\n```\n\n#### Hook management / Hook 管理\n\n```\n/sounds:cs hook status                  Show hook states / 查看状态\n/sounds:cs hook enable  permission          Enable tool-call sound / 开启工具调用提示音\n/sounds:cs hook enable  permission_request  Enable dialog-appear sound / 开启权限弹框提示音\n/sounds:cs hook disable stop            Disable stop sound / 关闭任务完成提示音\n```\n\n#### Theme store / 主题商店\n\n```\n/sounds:cs theme store list              List available themes / 查看可用主题\n/sounds:cs theme store install mario     Install a theme / 安装主题\n/sounds:cs theme store update            Update all themes / 更新所有主题\n```\n\n#### Local themes / 本地主题\n\n```\n/sounds:cs theme list                    List installed themes / 查看已安装主题\n/sounds:cs theme <name>                  Switch theme / 切换主题\n/sounds:cs theme pack ./mytheme          Pack a custom theme / 打包自制主题\n/sounds:cs theme install ./my.cstheme   Install local package / 安装本地主题包\n/sounds:cs theme remove  <name>          Remove theme / 删除主题\n/sounds:cs theme cache-clear             Clear audio cache / 清除缓存\n```\n\n#### Per-project config / 项目级配置\n\nRun from your project root; only affects that project.  \n在项目根目录运行，只影响当前项目：\n\n```\n/sounds:cs project theme mario           Set project theme / 设置项目主题\n/sounds:cs project hook disable stop     Disable stop in this project / 项目内关闭 stop\n/sounds:cs project hook status           Show project hook config / 查看项目 hook 配置\n/sounds:cs project status                Show full project config / 查看完整项目配置\n/sounds:cs project clear                 Reset to global config / 清除项目配置\n```\n\n#### Test sounds / 测试声音\n\n```\n/sounds:cs test          Play all sounds in sequence / 依次播放所有声音\n/sounds:cs test stop     Test a single sound / 只测试 stop\n```\n\n## Creating a Theme / 制作主题\n\nTheme packages are `.cstheme` files (custom binary format with SHA-256 integrity check).\n\n1. Create a folder with 5 MP3s + `manifest.json`:\n\n```\nmytheme/\n  stop.mp3               task completed\n  notification.mp3       input needed\n  error.mp3              error occurred\n  permission.mp3         before tool call\n  permission_request.mp3 when permission dialog appears\n  manifest.json          {\"name\":\"mytheme\",\"display_name\":\"My Theme\",\"version\":\"1.0.0\"}\n```\n\nAll sounds can reference the same MP3 file. / 所有文件可以是同一份音频的副本。\n\n2. Pack and install:\n\n```\n/sounds:cs theme pack ./mytheme\n/sounds:cs theme install ./mytheme.cstheme\n/sounds:cs theme mytheme\n```\n\nShare your theme by submitting a PR to [claude-sounds-themes](https://github.com/0xbaiqi/claude-sounds-themes).\n\n## User Data / 用户数据\n\nAll config and themes are stored under `~/.claude/claude-sounds-xapipro/`:\n\n```\nconfig.json     Global settings (theme, enabled, hooks, project registry)\nthemes/         User-installed themes\ncache/          Auto-extracted audio cache (safe to delete)\n```\n\nPer-project config is stored in `<project-root>/.claude/sounds.json`.\n\n## Uninstall / 卸载\n\n```bash\nbash uninstall.sh\n```\n\n## License / 协议\n\nMIT\n",
  "bytes": 4773,
  "sha": "54e7aa1ec2e7cc56b9fb5f315a7d27cedfa6095f04fbb8e8ee84c48fcc81d5db",
  "repo_slug": "0xbaiqi/claude-sounds-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_0xbaiqi_claude_sounds_plugin_sounds_18b75f7d/readme"
}