pingthings 0.2.1 → 0.4.0

package/README.md

@@ -134,7 +134,11 @@ 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 install <source>` | Install a pack from GitHub or local path |
+| `pingthings uninstall <pack>` | Remove a user-installed pack |
 
 ## Configuration
 
@@ -218,6 +222,15 @@ 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.
+
 ## Custom packs
 
 Place packs in `~/.config/pingthings/packs/<pack-name>/`:

package/bin/pingthings.js

@@ -15,9 +15,13 @@ 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'),
+  uninstall: () => import('../src/cli/uninstall.js'),
   init: () => import('../src/cli/init.js'),
   create: () => import('../src/cli/create.js'),
   theme: () => import('../src/cli/theme.js'),
@@ -34,6 +38,9 @@ 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
@@ -42,6 +49,7 @@ Commands:
   init               Set up Claude Code hooks automatically
   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
 
 Options:
   --help, -h         Show this help message

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pingthings",
-  "version": "0.2.1",
+  "version": "0.4.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/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

@@ -4,6 +4,7 @@
   "version": "1.0.0",
   "license": "GPL-2.0",
   "credits": "Battle for Wesnoth contributors (https://github.com/wesnoth/wesnoth) — licensed under GPL v2+",
+  "category": "fantasy",
   "sounds": [
     "sounds/axe.wav",
     "sounds/bow.wav",

package/src/cli/browse.js

@@ -0,0 +1,75 @@
+import { readConfig } from '../config.js';
+import { listPacks } from '../packs.js';
+
+function showHelp() {
+  console.log(`
+Usage: pingthings browse [category]
+
+Browse packs by category.
+
+With no arguments, shows all categories with pack counts.
+With a category, shows packs in that category.
+
+Categories: military, arena, fantasy, sci-fi, fps, retro, ui, transport, spooky, racing
+
+Examples:
+  pingthings browse              List all categories
+  pingthings browse military     Show military packs
+  pingthings browse sci-fi       Show sci-fi packs
+`);
+}
+
+export default function browse(args) {
+  if (args.includes('--help') || args.includes('-h')) {
+    showHelp();
+    return;
+  }
+
+  const config = readConfig();
+  const packs = listPacks();
+  const category = args[0];
+
+  if (!category) {
+    // Show all categories with counts
+    const categories = {};
+    for (const pack of packs) {
+      const cat = pack.category || 'other';
+      if (!categories[cat]) categories[cat] = [];
+      categories[cat].push(pack);
+    }
+
+    console.log('\nCategories:\n');
+    for (const [cat, catPacks] of Object.entries(categories).sort()) {
+      const totalSounds = catPacks.reduce((sum, p) => sum + p.soundCount, 0);
+      console.log(`  ${cat.padEnd(14)} ${catPacks.length} pack${catPacks.length === 1 ? '' : 's'}, ${totalSounds} sounds`);
+      for (const p of catPacks) {
+        const active = p.name === config.activePack ? ' *' : '  ';
+        console.log(`  ${active} └ ${p.name}`);
+      }
+    }
+    console.log('\n  * = active pack');
+    console.log('  Run "pingthings browse <category>" to see details.\n');
+    return;
+  }
+
+  // Show packs in a specific category
+  const filtered = packs.filter(p => (p.category || 'other') === category);
+
+  if (filtered.length === 0) {
+    console.error(`No packs found in category: ${category}`);
+    const allCats = [...new Set(packs.map(p => p.category || 'other'))].sort();
+    console.error(`Available categories: ${allCats.join(', ')}`);
+    process.exit(1);
+  }
+
+  console.log(`\n${category} packs:\n`);
+  for (const pack of filtered) {
+    const active = pack.name === config.activePack ? ' *' : '  ';
+    console.log(`${active} ${pack.name}  (${pack.soundCount} sounds)`);
+    if (pack.description) {
+      console.log(`     ${pack.description}`);
+    }
+    console.log(`     License: ${pack.license}`);
+  }
+  console.log('\n  * = active pack\n');
+}

package/src/cli/search.js

@@ -0,0 +1,81 @@
+import { readConfig } from '../config.js';
+import { listPacks, getPackSounds } from '../packs.js';
+import { basename } from 'node:path';
+
+function showHelp() {
+  console.log(`
+Usage: pingthings search <term>
+
+Search across all packs by name, description, category, or sound filename.
+
+Arguments:
+  term    Text to search for (case-insensitive)
+
+Examples:
+  pingthings search sword         Find packs/sounds with "sword"
+  pingthings search military      Find military category packs
+  pingthings search explosion     Find explosion sounds
+  pingthings search coin          Find coin/pickup sounds
+`);
+}
+
+export default function search(args) {
+  const term = args[0];
+
+  if (!term || term === '--help' || term === '-h') {
+    showHelp();
+    if (!term) process.exit(1);
+    return;
+  }
+
+  const query = term.toLowerCase();
+  const config = readConfig();
+  const packs = listPacks();
+  const results = { packs: [], sounds: [] };
+
+  for (const pack of packs) {
+    // Check pack-level matches
+    const packMatch =
+      pack.name.toLowerCase().includes(query) ||
+      pack.description.toLowerCase().includes(query) ||
+      (pack.category || '').toLowerCase().includes(query);
+
+    if (packMatch) {
+      results.packs.push(pack);
+    }
+
+    // Check individual sounds
+    const sounds = getPackSounds(pack.name);
+    for (const sound of sounds) {
+      const name = basename(sound).toLowerCase();
+      if (name.includes(query)) {
+        results.sounds.push({ pack: pack.name, sound: basename(sound), path: sound });
+      }
+    }
+  }
+
+  if (results.packs.length === 0 && results.sounds.length === 0) {
+    console.log(`No results for "${term}".`);
+    return;
+  }
+
+  if (results.packs.length > 0) {
+    console.log(`\nPacks matching "${term}":\n`);
+    for (const pack of results.packs) {
+      const active = pack.name === config.activePack ? ' *' : '  ';
+      console.log(`${active} ${pack.name}  (${pack.category}, ${pack.soundCount} sounds)`);
+      if (pack.description) {
+        console.log(`     ${pack.description}`);
+      }
+    }
+  }
+
+  if (results.sounds.length > 0) {
+    console.log(`\nSounds matching "${term}":\n`);
+    for (const s of results.sounds) {
+      console.log(`   ${s.pack} / ${s.sound}`);
+    }
+  }
+
+  console.log('');
+}

package/src/cli/sounds.js

@@ -0,0 +1,76 @@
+import { readConfig } from '../config.js';
+import { getPackSounds, resolvePack, getPackEvents, getEventSounds } from '../packs.js';
+import { basename } from 'node:path';
+
+function showHelp() {
+  console.log(`
+Usage: pingthings sounds [pack]
+
+List all individual sounds in a pack.
+
+Arguments:
+  pack    Pack to list sounds from (defaults to active pack)
+
+Options:
+  --events    Show sounds grouped by event mapping
+
+Examples:
+  pingthings sounds                      List sounds in active pack
+  pingthings sounds openarena-announcer  List sounds in a specific pack
+  pingthings sounds --events             Show event mappings
+`);
+}
+
+export default function sounds(args) {
+  if (args.includes('--help') || args.includes('-h')) {
+    showHelp();
+    return;
+  }
+
+  const showEvents = args.includes('--events');
+  const packName = args.find(a => !a.startsWith('-')) || readConfig().activePack;
+
+  const pack = resolvePack(packName);
+  if (!pack) {
+    console.error(`Pack not found: ${packName}`);
+    console.error('Run "pingthings list" to see available packs.');
+    process.exit(1);
+  }
+
+  const allSounds = getPackSounds(packName);
+
+  if (showEvents) {
+    const events = getPackEvents(packName);
+    console.log(`\n${packName} — sounds by event:\n`);
+
+    for (const event of events) {
+      const eventSounds = getEventSounds(packName, event);
+      console.log(`  ${event}:`);
+      for (const s of eventSounds) {
+        console.log(`    ${basename(s)}`);
+      }
+    }
+
+    // Show unmapped sounds
+    const mappedPaths = new Set();
+    for (const event of events) {
+      for (const s of getEventSounds(packName, event)) {
+        mappedPaths.add(s);
+      }
+    }
+    const unmapped = allSounds.filter(s => !mappedPaths.has(s));
+    if (unmapped.length > 0) {
+      console.log('  (unmapped):');
+      for (const s of unmapped) {
+        console.log(`    ${basename(s)}`);
+      }
+    }
+  } else {
+    console.log(`\n${packName} — ${allSounds.length} sounds:\n`);
+    for (const s of allSounds) {
+      console.log(`  ${basename(s)}`);
+    }
+  }
+
+  console.log('');
+}

package/src/cli/theme.js

@@ -57,11 +57,44 @@ const THEMES = {
       blocked: '0ad-civilizations',
     },
   },
+  'professional': {
+    description: 'Clean and minimal — Kenney UI sounds for everything',
+    activePack: 'kenney-interface',
+    eventPacks: {
+      done: 'kenney-interface',
+      permission: 'kenney-interface',
+      complete: 'kenney-interface',
+      error: 'kenney-interface',
+      blocked: 'kenney-interface',
+    },
+  },
+  '8bit': {
+    description: 'Pure retro — 8-bit chiptune for everything',
+    activePack: 'retro-8bit',
+    eventPacks: {
+      done: 'retro-8bit',
+      permission: 'retro-8bit',
+      complete: 'retro-8bit',
+      error: 'retro-8bit',
+      blocked: 'retro-8bit',
+    },
+  },
+  'space': {
+    description: 'Space station — Warzone 2100 + Kenney sci-fi',
+    activePack: 'kenney-scifi',
+    eventPacks: {
+      done: 'kenney-scifi',
+      permission: 'warzone2100-command',
+      complete: 'warzone2100-command',
+      error: 'kenney-scifi',
+      blocked: 'kenney-scifi',
+    },
+  },
   'chaos': {
     description: 'Random pack for every event — maximum variety',
     activePack: '7kaa-soldiers',
     eventPacks: {
-      done: '7kaa-soldiers',
+      done: 'retro-8bit',
       permission: 'openarena-announcer',
       complete: 'warzone2100-command',
       error: 'freedoom-arsenal',

package/src/cli/uninstall.js

@@ -0,0 +1,48 @@
+import { existsSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { getConfigDir, readConfig, writeConfig } from '../config.js';
+
+function showHelp() {
+  console.log(`
+Usage: pingthings uninstall <pack>
+
+Remove a user-installed sound pack.
+
+Built-in packs cannot be uninstalled. Only packs in
+~/.config/pingthings/packs/ can be removed.
+
+Arguments:
+  pack    Name of the pack to remove
+`);
+}
+
+export default function uninstall(args) {
+  const packName = args[0];
+
+  if (!packName || packName === '--help' || packName === '-h') {
+    showHelp();
+    if (!packName) process.exit(1);
+    return;
+  }
+
+  const userPackDir = join(getConfigDir(), 'packs', packName);
+
+  if (!existsSync(userPackDir)) {
+    console.error(`Pack not found in user packs: ${packName}`);
+    console.error('Only user-installed packs can be uninstalled.');
+    console.error('Run "pingthings list" to see all packs.');
+    process.exit(1);
+  }
+
+  rmSync(userPackDir, { recursive: true });
+
+  // If this was the active pack, reset to default
+  const config = readConfig();
+  if (config.activePack === packName) {
+    config.activePack = '7kaa-soldiers';
+    writeConfig(config);
+    console.log(`Active pack reset to: 7kaa-soldiers`);
+  }
+
+  console.log(`Uninstalled: ${packName}`);
+}

package/src/packs.js

@@ -16,8 +16,13 @@ function readManifest(packDir) {
   const manifestPath = join(packDir, 'manifest.json');
   if (!existsSync(manifestPath)) return null;
   try {
-    return JSON.parse(readFileSync(manifestPath, 'utf8'));
-  } catch {
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    if (!manifest.name) {
+      console.error(`Warning: manifest.json in ${packDir} is missing "name" field`);
+    }
+    return manifest;
+  } catch (err) {
+    console.error(`Warning: Failed to parse ${manifestPath}: ${err.message}`);
     return null;
   }
 }
@@ -52,6 +57,7 @@ function scanDirectory(dir, isBuiltIn) {
         description: manifest?.description || '',
         license: manifest?.license || 'Unknown',
         credits: manifest?.credits || '',
+        category: manifest?.category || 'other',
         location: packDir,
         soundCount: sounds.length,
         isBuiltIn,

package/src/player.js

@@ -81,8 +81,12 @@ export function playSoundSync(filePath, volume) {
   const args = buildArgs(cmd, filePath, volume);
 
   try {
-    execFileSync(cmd, args, { stdio: 'ignore', timeout: 10000 });
-  } catch {
-    // Timeout or error — don't crash
+    execFileSync(cmd, args, { stdio: ['ignore', 'ignore', 'pipe'], timeout: 5000 });
+  } catch (err) {
+    if (err.killed) {
+      console.error(`Warning: Sound playback timed out for ${filePath}`);
+    } else if (err.stderr?.length) {
+      console.error(`Warning: Playback error: ${err.stderr.toString().trim()}`);
+    }
   }
 }