vibe-notify 0.2.0 → 0.2.2

package/README.ja.md

@@ -103,10 +103,17 @@ vibe-notify [options] [sound-name]
 
 - **ランタイム依存ゼロ** — すべてのサウンド生成は純粋な Node.js で行います
 - 内蔵サウンドは WAV オーディオとしてメモリ上で生成（エンベロープ付き正弦波）
-- 再生にはネイティブシステムプレイヤーを使用：PowerShell SoundPlayer (Windows)、afplay (macOS)、paplay/aplay (Linux)
-- WAV 再生に失敗した場合は `[System.Console]::Beep()` または端末ベルにフォールバック
 - 一時ファイルは再生後すぐにクリーンアップ
 
+### ファイルフォーマット対応
+
+| フォーマット | Windows | macOS | Linux |
+|--------|---------|-------|-------|
+| `.wav` | ✅ ネイティブ | ✅ ネイティブ | ✅ ネイティブ |
+| `.mp3` / その他 | ✅ ffplay¹ | ✅ ネイティブ | ✅ ffplay¹ |
+
+¹ ffmpeg をインストール: `winget install ffmpeg` (Windows) / `sudo apt install ffmpeg` (Linux)
+
 ## ライセンス
 
 MIT

package/README.md

@@ -91,7 +91,7 @@ Replace `"npx", "-y", "vibe-notify"` with `"vibe-notify"` if installed globally.
 ## CLI Reference
 
 ```
-vibe-notify [options] [sound-name]
+vibe-notify [options] [sound-name | file-path]
 
 Options:
   --help, -h       Show help
@@ -99,16 +99,26 @@ Options:
   --config, -c     Print config file path
   --init           Create default config file
   --version, -v    Show version
+
+You can also pass a path to a .wav/.mp3 file directly:
+  vibe-notify "C:\my-sounds\alert.wav"
 ```
 
 ## How It Works
 
 - **Zero runtime dependencies** — all sound generation is pure Node.js
 - Built-in sounds are generated as WAV audio in-memory (sine waves with envelope)
-- Playback uses native system players: PowerShell SoundPlayer (Windows), afplay (macOS), paplay/aplay (Linux)
-- Falls back to `[System.Console]::Beep()` or terminal bell if WAV playback fails
 - Temp files are cleaned up immediately after playback
 
+### File Format Support
+
+| Format | Windows | macOS | Linux |
+|--------|---------|-------|-------|
+| `.wav` | ✅ Native | ✅ Native | ✅ Native |
+| `.mp3` / other | ✅ ffplay¹ | ✅ Native | ✅ ffplay¹ |
+
+¹ Install ffmpeg: `winget install ffmpeg` (Windows) / `sudo apt install ffmpeg` (Linux)
+
 ## License
 
 MIT

package/README.zh-CN.md

@@ -103,10 +103,17 @@ vibe-notify [options] [sound-name]
 
 - **零运行时依赖** — 所有音频均使用纯 Node.js 生成
 - 内置音效以 WAV 格式在内存中生成（带包络的正弦波）
-- 播放使用系统原生播放器：PowerShell SoundPlayer (Windows)、afplay (macOS)、paplay/aplay (Linux)
-- 如果 WAV 播放失败，回退到 `[System.Console]::Beep()` 或终端响铃
 - 临时文件在播放后立即清理
 
+### 文件格式支持
+
+| 格式 | Windows | macOS | Linux |
+|--------|---------|-------|-------|
+| `.wav` | ✅ 原生 | ✅ 原生 | ✅ 原生 |
+| `.mp3` / 其他 | ✅ ffplay¹ | ✅ 原生 | ✅ ffplay¹ |
+
+¹ 安装 ffmpeg：`winget install ffmpeg` (Windows) / `sudo apt install ffmpeg` (Linux)
+
 ## 许可证
 
 MIT

package/dist/index.js

@@ -42,6 +42,17 @@ async function main() {
     // ── Play sound ───────────────────────────────────────────────────────
     const config = (0, config_1.loadConfig)();
     const soundName = cli.soundName || config.sound;
+    // If the argument is a path to an existing file, play it directly
+    if (soundName && (0, fs_1.existsSync)(soundName)) {
+        try {
+            await (0, player_1.playFile)(soundName, config.playback.method);
+        }
+        catch (err) {
+            console.error(`Failed to play file: ${err.message}`);
+            process.exit(1);
+        }
+        return;
+    }
     // Validate sound name
     if (soundName !== 'custom' && !(0, beep_1.getPatternByName)(soundName)) {
         console.error(`Unknown sound: "${soundName}"`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-notify",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Notification sounds for Claude Code completions — customizable beeps when your session finishes",
   "keywords": ["claude", "claude-code", "notification", "sound", "beep", "alert"],
   "license": "MIT",