pingthings 0.9.0 → 1.0.0

package/LICENSE

@@ -27,4 +27,42 @@ warzone2100-command: Warzone 2100
 0ad-civilizations: 0 A.D.
   Copyright Wildfire Games — CC-BY-SA 3.0
   Distributed as part of this aggregate work alongside GPL v2 code.
-  See packs/0ad-civilizations/manifest.json for full attribution.
+
+xonotic-announcer: Xonotic
+  Copyright Xonotic Project — GPL v2+
+
+fighting-announcer: Fighting Game Announcer
+  Copyright Alba MacKenna — CC-BY 4.0
+
+retro-8bit: 8-bit Sound Effects
+  Copyright Juhani Junkala / SubspaceAudio — CC0
+
+retro-weapons: 8-bit Weapons (from same collection)
+  Copyright Juhani Junkala / SubspaceAudio — CC0
+
+retro-movement: 8-bit Movement (from same collection)
+  Copyright Juhani Junkala / SubspaceAudio — CC0
+
+kenney-interface: Interface Sounds
+  Copyright Kenney (kenney.nl) — CC0
+
+kenney-scifi: Sci-fi Sounds
+  Copyright Kenney (kenney.nl) — CC0
+
+kenney-voiceover: Voiceover Pack
+  Copyright Kenney (kenney.nl) — CC0
+
+kenney-fighter: Voiceover Pack: Fighter
+  Copyright Kenney (kenney.nl) — CC0
+
+kenney-digital: Digital Audio
+  Copyright Kenney (kenney.nl) — CC0
+
+kenney-rpg: RPG Audio
+  Copyright Kenney (kenney.nl) — CC0
+
+kenney-impacts: Impact Sounds
+  Copyright Kenney (kenney.nl) — CC0
+
+droid-announcer: DROID Video Game Announcer
+  Copyright VoiceBosch — CC-BY-SA 4.0

package/README.md

@@ -140,7 +140,12 @@ For different sounds based on what Claude is doing, set up multiple hooks:
 | `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 demo` | Play one sound from every pack — showroom tour |
+| `pingthings stats` | Show usage statistics |
+| `pingthings setup <ide>` | Configure hooks for any IDE (cursor, copilot, codex, etc.) |
 | `pingthings doctor` | Diagnose audio setup and configuration |
+| `pingthings update` | Check for new versions on npm |
+| `pingthings cesp [pack\|--all]` | Generate CESP-compatible manifests |
 | `pingthings completions <shell>` | Generate shell completions (bash/zsh/fish) |
 
 ## Configuration
@@ -153,7 +158,10 @@ Config lives at `~/.config/pingthings/config.json`:
   "mode": "random",
   "specificSound": null,
   "volume": 100,
-  "eventPacks": {}
+  "eventPacks": {},
+  "cooldown": true,
+  "quietHours": null,
+  "notifications": false
 }
 ```
 
@@ -162,6 +170,9 @@ Config lives at `~/.config/pingthings/config.json`:
 - **specificSound** — sound name to always play when mode is `"specific"`
 - **volume** — playback volume, 0-100 (default: 100)
 - **eventPacks** — per-event pack overrides (e.g. `{"error": "freedoom-arsenal"}`)
+- **cooldown** — avoid repeating the same sound twice in a row (default: true)
+- **quietHours** — mute during hours, e.g. `"22-7"` for 10pm-7am (default: null)
+- **notifications** — show desktop notifications alongside sound (default: false)
 
 Set values via CLI:
 
@@ -240,6 +251,30 @@ Arena FPS announcer voice lines from **Xonotic** — 15 sounds including "awesom
 ### fighting-announcer
 Fighting game announcer voice lines — 20 sounds including "Fight!", "Victory!", "K.O!", "Game Over!", "Ready?", "You Win!". License: CC-BY 4.0.
 
+### kenney-voiceover
+Human voice notifications by **Kenney** — 19 sounds including "mission completed", "objective achieved", "game over", "congratulations". License: CC0.
+
+### droid-announcer
+Robotic AI voice lines — 15 sounds including "objective complete", "action required", "instruction unclear", "mission complete". Perfect for AI coding tools. License: CC-BY-SA 4.0.
+
+### kenney-digital
+Digital and space notification tones by **Kenney** — 18 sounds including power-ups, phasers, zaps, and bleeps. License: CC0.
+
+### kenney-rpg
+Fantasy RPG foley sounds by **Kenney** — 18 sounds including metal latches, book flips, sword draws, door creaks. License: CC0.
+
+### kenney-impacts
+Material impact sounds by **Kenney** — 18 sounds including metal plates, wood, glass, bells, and mining. License: CC0.
+
+### kenney-fighter
+Female fighting game announcer by **Kenney** — 18 sounds including "flawless victory!", "combo breaker!", "prepare yourself!". License: CC0.
+
+### retro-weapons
+8-bit weapons, explosions, and death screams — 18 sounds from the SubspaceAudio collection. License: CC0.
+
+### retro-movement
+8-bit portals, doors, jumps, and bleeps — 18 sounds from the SubspaceAudio collection. License: CC0.
+
 ## Custom packs
 
 Place packs in `~/.config/pingthings/packs/<pack-name>/`:
@@ -303,6 +338,10 @@ pingthings theme reset        # back to defaults
 | `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 |
+| `developer` | AI assistant vibes — droid announcer + human voiceover |
+| `arcade` | Full 8-bit arcade experience |
+| `tabletop` | Tavern sounds — RPG foley + material impacts |
+| `tournament` | Fighting game tournament — multiple announcers |
 | `chaos` | Different pack for every event — maximum variety |
 
 ## Tools

package/package.json

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

package/src/cli/completions.js

@@ -17,12 +17,14 @@ Install:
 const COMMANDS = [
   'play', 'list', 'select', 'browse', 'search', 'sounds',
   'use', 'preview', 'test-events', 'theme', 'config',
-  'init', 'create', 'install', 'uninstall', 'random-pack', 'doctor', 'completions',
+  'init', 'setup', 'demo', 'stats', 'create', 'install', 'uninstall',
+  'random-pack', 'doctor', 'update', 'cesp', 'completions',
 ];
 
 const THEMES = [
   'retro', 'sci-fi', 'arena', 'fantasy', 'ancient',
-  'professional', '8bit', 'space', 'chaos', 'reset',
+  'professional', '8bit', 'space', 'developer', 'arcade',
+  'tabletop', 'tournament', 'chaos', 'reset',
 ];
 
 const EVENTS = ['done', 'permission', 'complete', 'error', 'blocked'];
@@ -92,6 +94,11 @@ _pingthings() {
     'uninstall:Remove a user-installed pack'
     'random-pack:Switch to a random pack'
     'doctor:Diagnose audio setup'
+    'setup:Configure hooks for any IDE'
+    'demo:Play one sound from every pack'
+    'stats:Show usage statistics'
+    'update:Check for new versions'
+    'cesp:Generate CESP manifests'
     'completions:Generate shell completions'
   )
   themes=(${THEMES.join(' ')})

package/src/cli/doctor.js

@@ -33,7 +33,8 @@ function check(label, fn) {
 
 function commandExists(cmd) {
   try {
-    execFileSync('which', [cmd], { stdio: 'pipe' });
+    const checker = platform() === 'win32' ? 'where' : 'which';
+    execFileSync(checker, [cmd], { stdio: 'pipe' });
     return true;
   } catch {
     return false;

package/src/cli/stats.js

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync, renameSync } from 'node:fs';
 import { join } from 'node:path';
 import { readConfig, getConfigDir } from '../config.js';
 import { listPacks } from '../packs.js';
@@ -40,7 +40,9 @@ export function recordPlay(packName, event) {
   stats.dailyPlays[today] = (stats.dailyPlays[today] || 0) + 1;
 
   try {
-    writeFileSync(statsPath, JSON.stringify(stats, null, 2) + '\n', 'utf8');
+    const tmpPath = statsPath + '.tmp';
+    writeFileSync(tmpPath, JSON.stringify(stats, null, 2) + '\n', 'utf8');
+    renameSync(tmpPath, statsPath);
   } catch {}
 }
 

package/src/notify.js

@@ -1,19 +1,24 @@
 import { spawn } from 'node:child_process';
 import { platform } from 'node:os';
 
+function sanitize(str) {
+  return str.replace(/[\\"]/g, '').replace(/[^\x20-\x7E]/g, '');
+}
+
 export function sendNotification(title, message) {
   const os = platform();
+  const safeTitle = sanitize(title);
+  const safeMessage = sanitize(message);
 
   if (os === 'darwin') {
     spawn('osascript', [
       '-e',
-      `display notification "${message}" with title "${title}"`,
-    ], { detached: true, stdio: 'ignore' }).unref();
+      `display notification "${safeMessage}" with title "${safeTitle}"`,
+    ], { detached: true, stdio: 'ignore' }).on('error', () => {}).unref();
   } else if (os === 'linux') {
-    spawn('notify-send', [title, message], {
+    spawn('notify-send', [safeTitle, safeMessage], {
       detached: true,
       stdio: 'ignore',
     }).on('error', () => {}).unref();
   }
-  // Windows: no native CLI notification without dependencies, skip for now
 }

package/src/player.js

@@ -4,7 +4,8 @@ import { platform } from 'node:os';
 
 function commandExists(cmd) {
   try {
-    execFileSync('which', [cmd], { stdio: 'pipe' });
+    const checker = platform() === 'win32' ? 'where' : 'which';
+    execFileSync(checker, [cmd], { stdio: 'pipe' });
     return true;
   } catch {
     return false;