pingthings 0.3.0 → 0.5.0

package/README.md

@@ -134,8 +134,14 @@ For different sounds based on what Claude is doing, set up multiple hooks:
 | `pingthings config [key] [val]` | Show or update configuration |
 | `pingthings init` | Set up Claude Code hooks automatically |
 | `pingthings create <dir>` | Create a pack from audio files |
+| `pingthings browse [category]` | Browse packs by category |
+| `pingthings search <term>` | Search packs and sounds |
+| `pingthings sounds [pack]` | List individual sounds in a pack |
+| `pingthings random-pack` | Switch to a random pack |
 | `pingthings install <source>` | Install a pack from GitHub or local path |
 | `pingthings uninstall <pack>` | Remove a user-installed pack |
+| `pingthings doctor` | Diagnose audio setup and configuration |
+| `pingthings completions <shell>` | Generate shell completions (bash/zsh/fish) |
 
 ## Configuration
 
@@ -219,6 +225,21 @@ Sci-fi military commander voice lines from **Warzone 2100** — 21 sounds includ
 ### 0ad-civilizations
 Ancient civilization voice lines and alerts from **0 A.D.** — 28 sounds with Greek, Latin, and Persian voice acknowledgements ("my lord", "as you wish", "by your order") plus alarm sounds (victory, defeat, attack). License: CC-BY-SA 3.0.
 
+### retro-8bit
+Classic 8-bit chiptune notification sounds — 18 sounds including coins, fanfares, power-ups, error buzzes, and button clicks. Perfect for that retro gaming feel. License: CC0.
+
+### kenney-interface
+Clean modern UI notification sounds by **Kenney** — 18 sounds including confirmations, questions, errors, glitches, and bongs. Professional and minimal. License: CC0.
+
+### kenney-scifi
+Futuristic sci-fi notification sounds by **Kenney** — 18 sounds including computer noises, force fields, lasers, explosions, and thrusters. License: CC0.
+
+### xonotic-announcer
+Arena FPS announcer voice lines from **Xonotic** — 15 sounds including "awesome!", "amazing!", "impressive!", "prepare for battle!", "terminated!". License: GPL v2+.
+
+### fighting-announcer
+Fighting game announcer voice lines — 20 sounds including "Fight!", "Victory!", "K.O!", "Game Over!", "Ready?", "You Win!". License: CC-BY 4.0.
+
 ## Custom packs
 
 Place packs in `~/.config/pingthings/packs/<pack-name>/`:
@@ -279,6 +300,9 @@ pingthings theme reset        # back to defaults
 | `arena` | Arena announcer with FPS weapons for errors |
 | `fantasy` | Medieval fantasy — Wesnoth + 0 A.D. civilizations |
 | `ancient` | Ancient world — 7kaa soldiers + 0 A.D. voices |
+| `professional` | Clean and minimal — Kenney UI sounds for everything |
+| `8bit` | Pure retro — 8-bit chiptune for everything |
+| `space` | Space station — Warzone 2100 + Kenney sci-fi |
 | `chaos` | Different pack for every event — maximum variety |
 
 ## Tools

package/bin/pingthings.js

@@ -15,6 +15,9 @@ const commands = {
   list: () => import('../src/cli/list.js'),
   use: () => import('../src/cli/use.js'),
   select: () => import('../src/cli/select.js'),
+  browse: () => import('../src/cli/browse.js'),
+  search: () => import('../src/cli/search.js'),
+  sounds: () => import('../src/cli/sounds.js'),
   preview: () => import('../src/cli/preview.js'),
   config: () => import('../src/cli/config.js'),
   install: () => import('../src/cli/install.js'),
@@ -23,6 +26,9 @@ const commands = {
   create: () => import('../src/cli/create.js'),
   theme: () => import('../src/cli/theme.js'),
   'test-events': () => import('../src/cli/test-events.js'),
+  'random-pack': () => import('../src/cli/random-pack.js'),
+  doctor: () => import('../src/cli/doctor.js'),
+  completions: () => import('../src/cli/completions.js'),
 };
 
 function showHelp() {
@@ -35,15 +41,21 @@ Commands:
   play [sound]       Play a sound from the active pack (random by default)
   list               Show available sound packs
   select             Interactive pack selector
+  browse [category]  Browse packs by category
+  search <term>      Search packs and sounds
+  sounds [pack]      List individual sounds in a pack
   use <pack>         Set the active sound pack
   preview <pack>     Preview a random sound from a pack
   test-events [pack] Play all event sounds to hear what each one sounds like
   theme [name]       Apply a sound theme (maps events across packs)
   config [key] [val] Show or update configuration
   init               Set up Claude Code hooks automatically
+  random-pack        Switch to a random pack
   create <dir>       Create a new pack from a folder of audio files
   install <source>   Install a pack from GitHub or URL
   uninstall <pack>   Remove a user-installed pack
+  doctor             Diagnose audio setup and configuration
+  completions <shell> Generate shell completions (bash/zsh/fish)
 
 Options:
   --help, -h         Show this help message

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pingthings",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Notification sounds for Claude Code and other CLI tools",
   "type": "module",
   "license": "GPL-2.0",

package/packs/0ad-civilizations/manifest.json

@@ -4,6 +4,7 @@
   "version": "1.0.0",
   "license": "CC-BY-SA-3.0",
   "credits": "Wildfire Games / 0 A.D. (https://github.com/0ad/0ad) — audio licensed under CC-BY-SA 3.0",
+  "category": "military",
   "sounds": [
     "sounds/alarm-alert.wav",
     "sounds/alarm-attack.wav",

package/packs/7kaa-soldiers/manifest.json

@@ -4,6 +4,7 @@
   "version": "1.0.0",
   "license": "GPL-2.0",
   "credits": "Enlight Software Ltd. / Seven Kingdoms: Ancient Adversaries (https://github.com/the3dfxdude/7kaa)",
+  "category": "military",
   "sounds": [
     "sounds/00001-CH_A2.wav",
     "sounds/00006-NO_V2.wav",

package/packs/fighting-announcer/manifest.json

@@ -0,0 +1,62 @@
+{
+  "name": "fighting-announcer",
+  "description": "Fighting game announcer voice lines",
+  "version": "1.0.0",
+  "license": "CC-BY-4.0",
+  "credits": "Alba MacKenna (https://opengameart.org/content/voice-pack%E2%94%82fighting-game-announcer)",
+  "category": "arena",
+  "sounds": [
+    "sounds/begin.wav",
+    "sounds/complete.wav",
+    "sounds/congratulations.wav",
+    "sounds/defeat.wav",
+    "sounds/failure.wav",
+    "sounds/fight.wav",
+    "sounds/final-round.wav",
+    "sounds/finish.wav",
+    "sounds/game-over.wav",
+    "sounds/get-set.wav",
+    "sounds/go.wav",
+    "sounds/great.wav",
+    "sounds/high-score.wav",
+    "sounds/new-record.wav",
+    "sounds/no-contest.wav",
+    "sounds/ready.wav",
+    "sounds/sudden-death.wav",
+    "sounds/victory.wav",
+    "sounds/you-lose.wav",
+    "sounds/you-win.wav"
+  ],
+  "events": {
+    "done": [
+      "sounds/complete.wav",
+      "sounds/great.wav",
+      "sounds/finish.wav",
+      "sounds/new-record.wav"
+    ],
+    "permission": [
+      "sounds/fight.wav",
+      "sounds/ready.wav",
+      "sounds/get-set.wav",
+      "sounds/begin.wav",
+      "sounds/go.wav"
+    ],
+    "complete": [
+      "sounds/victory.wav",
+      "sounds/you-win.wav",
+      "sounds/congratulations.wav",
+      "sounds/high-score.wav"
+    ],
+    "error": [
+      "sounds/game-over.wav",
+      "sounds/defeat.wav",
+      "sounds/you-lose.wav",
+      "sounds/failure.wav"
+    ],
+    "blocked": [
+      "sounds/sudden-death.wav",
+      "sounds/final-round.wav",
+      "sounds/no-contest.wav"
+    ]
+  }
+}

package/packs/freedoom-arsenal/manifest.json

@@ -4,6 +4,7 @@
   "version": "1.0.0",
   "license": "BSD-3-Clause",
   "credits": "Freedoom contributors (https://github.com/freedoom/freedoom)",
+  "category": "fps",
   "sounds": [
     "sounds/dsbarexp.wav",
     "sounds/dsbfg.wav",

package/packs/kenney-interface/manifest.json

@@ -0,0 +1,58 @@
+{
+  "name": "kenney-interface",
+  "description": "Clean modern UI notification sounds by Kenney",
+  "version": "1.0.0",
+  "license": "CC0-1.0",
+  "credits": "Kenney (https://kenney.nl)",
+  "category": "ui",
+  "sounds": [
+    "sounds/back-1.wav",
+    "sounds/bong.wav",
+    "sounds/click-1.wav",
+    "sounds/close-1.wav",
+    "sounds/confirmation-1.wav",
+    "sounds/confirmation-2.wav",
+    "sounds/confirmation-3.wav",
+    "sounds/error-1.wav",
+    "sounds/error-2.wav",
+    "sounds/error-3.wav",
+    "sounds/glitch-1.wav",
+    "sounds/maximize-1.wav",
+    "sounds/maximize-2.wav",
+    "sounds/open-1.wav",
+    "sounds/pluck-1.wav",
+    "sounds/question-1.wav",
+    "sounds/question-2.wav",
+    "sounds/question-3.wav"
+  ],
+  "events": {
+    "done": [
+      "sounds/confirmation-1.wav",
+      "sounds/confirmation-2.wav",
+      "sounds/confirmation-3.wav",
+      "sounds/click-1.wav"
+    ],
+    "permission": [
+      "sounds/question-1.wav",
+      "sounds/question-2.wav",
+      "sounds/question-3.wav",
+      "sounds/pluck-1.wav"
+    ],
+    "complete": [
+      "sounds/maximize-1.wav",
+      "sounds/maximize-2.wav",
+      "sounds/bong.wav",
+      "sounds/open-1.wav"
+    ],
+    "error": [
+      "sounds/error-1.wav",
+      "sounds/error-2.wav",
+      "sounds/error-3.wav",
+      "sounds/glitch-1.wav"
+    ],
+    "blocked": [
+      "sounds/close-1.wav",
+      "sounds/back-1.wav"
+    ]
+  }
+}

package/packs/kenney-scifi/manifest.json

@@ -0,0 +1,58 @@
+{
+  "name": "kenney-scifi",
+  "description": "Futuristic sci-fi notification sounds by Kenney",
+  "version": "1.0.0",
+  "license": "CC0-1.0",
+  "credits": "Kenney (https://kenney.nl)",
+  "category": "sci-fi",
+  "sounds": [
+    "sounds/computer-1.wav",
+    "sounds/computer-2.wav",
+    "sounds/computer-3.wav",
+    "sounds/door-close.wav",
+    "sounds/door-open.wav",
+    "sounds/engine-1.wav",
+    "sounds/explosion-1.wav",
+    "sounds/explosion-2.wav",
+    "sounds/forcefield-1.wav",
+    "sounds/forcefield-2.wav",
+    "sounds/impact-1.wav",
+    "sounds/impact-2.wav",
+    "sounds/laser-large.wav",
+    "sounds/laser-retro.wav",
+    "sounds/low-explosion.wav",
+    "sounds/slime.wav",
+    "sounds/thruster-1.wav",
+    "sounds/thruster-2.wav"
+  ],
+  "events": {
+    "done": [
+      "sounds/computer-1.wav",
+      "sounds/computer-2.wav",
+      "sounds/computer-3.wav",
+      "sounds/door-open.wav"
+    ],
+    "permission": [
+      "sounds/forcefield-1.wav",
+      "sounds/forcefield-2.wav",
+      "sounds/laser-retro.wav"
+    ],
+    "complete": [
+      "sounds/thruster-1.wav",
+      "sounds/thruster-2.wav",
+      "sounds/engine-1.wav"
+    ],
+    "error": [
+      "sounds/explosion-1.wav",
+      "sounds/explosion-2.wav",
+      "sounds/low-explosion.wav",
+      "sounds/impact-1.wav",
+      "sounds/impact-2.wav"
+    ],
+    "blocked": [
+      "sounds/door-close.wav",
+      "sounds/laser-large.wav",
+      "sounds/slime.wav"
+    ]
+  }
+}

package/packs/openarena-announcer/manifest.json

@@ -4,6 +4,7 @@
   "version": "1.0.0",
   "license": "GPL-2.0",
   "credits": "OpenArena contributors (http://openarena.ws)",
+  "category": "arena",
   "sounds": [
     "sounds/accuracy.wav",
     "sounds/assist.wav",

package/packs/retro-8bit/manifest.json

@@ -0,0 +1,58 @@
+{
+  "name": "retro-8bit",
+  "description": "Classic 8-bit chiptune notification sounds",
+  "version": "1.0.0",
+  "license": "CC0-1.0",
+  "credits": "Juhani Junkala / SubspaceAudio (https://opengameart.org/content/512-sound-effects-8-bit-style)",
+  "category": "retro",
+  "sounds": [
+    "sounds/button-1.wav",
+    "sounds/button-2.wav",
+    "sounds/button-3.wav",
+    "sounds/coin-1.wav",
+    "sounds/coin-2.wav",
+    "sounds/coin-cluster.wav",
+    "sounds/coin-double.wav",
+    "sounds/damage-1.wav",
+    "sounds/error-1.wav",
+    "sounds/error-2.wav",
+    "sounds/error-3.wav",
+    "sounds/fanfare-1.wav",
+    "sounds/fanfare-2.wav",
+    "sounds/fanfare-3.wav",
+    "sounds/negative-1.wav",
+    "sounds/negative-2.wav",
+    "sounds/powerup-1.wav",
+    "sounds/powerup-2.wav"
+  ],
+  "events": {
+    "done": [
+      "sounds/coin-1.wav",
+      "sounds/coin-2.wav",
+      "sounds/coin-double.wav",
+      "sounds/coin-cluster.wav"
+    ],
+    "permission": [
+      "sounds/button-1.wav",
+      "sounds/button-2.wav",
+      "sounds/button-3.wav"
+    ],
+    "complete": [
+      "sounds/fanfare-1.wav",
+      "sounds/fanfare-2.wav",
+      "sounds/fanfare-3.wav",
+      "sounds/powerup-1.wav",
+      "sounds/powerup-2.wav"
+    ],
+    "error": [
+      "sounds/error-1.wav",
+      "sounds/error-2.wav",
+      "sounds/error-3.wav",
+      "sounds/damage-1.wav"
+    ],
+    "blocked": [
+      "sounds/negative-1.wav",
+      "sounds/negative-2.wav"
+    ]
+  }
+}

package/packs/warzone2100-command/manifest.json

@@ -4,6 +4,7 @@
   "version": "1.0.0",
   "license": "GPL-2.0",
   "credits": "Warzone 2100 Project (https://github.com/Warzone2100/warzone2100)",
+  "category": "military",
   "sounds": [
     "sounds/construction-completed.wav",
     "sounds/design-completed.wav",

package/packs/wesnoth-combat/manifest.json

@@ -2,8 +2,9 @@
   "name": "wesnoth-combat",
   "description": "Fantasy combat and magic sounds from Battle for Wesnoth",
   "version": "1.0.0",
-  "license": "GPL-2.0",
+  "license": "GPL-2.0-or-later",
   "credits": "Battle for Wesnoth contributors (https://github.com/wesnoth/wesnoth) — licensed under GPL v2+",
+  "category": "fantasy",
   "sounds": [
     "sounds/axe.wav",
     "sounds/bow.wav",

package/packs/xonotic-announcer/manifest.json

@@ -0,0 +1,52 @@
+{
+  "name": "xonotic-announcer",
+  "description": "Arena FPS announcer voice lines from Xonotic",
+  "version": "1.0.0",
+  "license": "GPL-2.0-or-later",
+  "credits": "Xonotic Project (https://github.com/xonotic/xonotic-data.pk3dir)",
+  "category": "arena",
+  "sounds": [
+    "sounds/1fragleft.wav",
+    "sounds/airshot.wav",
+    "sounds/amazing.wav",
+    "sounds/awesome.wav",
+    "sounds/begin.wav",
+    "sounds/botlike.wav",
+    "sounds/electrobitch.wav",
+    "sounds/headshot.wav",
+    "sounds/impressive.wav",
+    "sounds/lastsecond.wav",
+    "sounds/leadgained.wav",
+    "sounds/narrowly.wav",
+    "sounds/prepareforbattle.wav",
+    "sounds/terminated.wav",
+    "sounds/yoda.wav"
+  ],
+  "events": {
+    "done": [
+      "sounds/awesome.wav",
+      "sounds/amazing.wav",
+      "sounds/impressive.wav",
+      "sounds/airshot.wav"
+    ],
+    "permission": [
+      "sounds/prepareforbattle.wav",
+      "sounds/begin.wav",
+      "sounds/1fragleft.wav"
+    ],
+    "complete": [
+      "sounds/yoda.wav",
+      "sounds/botlike.wav",
+      "sounds/leadgained.wav"
+    ],
+    "error": [
+      "sounds/terminated.wav",
+      "sounds/headshot.wav",
+      "sounds/electrobitch.wav"
+    ],
+    "blocked": [
+      "sounds/lastsecond.wav",
+      "sounds/narrowly.wav"
+    ]
+  }
+}