@domdhi/claude-code-tts 1.2.0 → 1.3.0

package/.claude/hooks/tts/daemon.py

@@ -3,7 +3,7 @@
 claude-code-tts — TTS daemon
 Persistent background process. Keeps model loaded. Serves speech via TCP.
 
-Protocol (JSON lines over localhost:6254):
+Protocol (JSON lines over localhost — port derived from install dir):
   {"cmd": "speak", "text": "...", "voice": "af_heart", "speed": 1.0, "project": "repo-name"}
   {"cmd": "stop"}
   {"cmd": "ping"}
@@ -30,8 +30,12 @@ os.environ.setdefault('OMP_NUM_THREADS', '6')
 os.environ.setdefault('ONNXRUNTIME_NUM_THREADS', '6')
 
 HOST = '127.0.0.1'
-PORT = 6254
 DAEMON_DIR = os.path.dirname(os.path.abspath(__file__))
+
+# Port is derived from install location — each install gets its own daemon port,
+# so multiple projects with local installs don't collide.
+import hashlib as _hashlib
+PORT = 49152 + (int(_hashlib.md5(DAEMON_DIR.encode()).hexdigest(), 16) % 16384)
 PID_FILE = os.path.join(DAEMON_DIR, 'daemon.pid')
 MODEL_PATH = os.path.join(DAEMON_DIR, 'models', 'kokoro-v1.0.onnx')
 VOICES_PATH = os.path.join(DAEMON_DIR, 'models', 'voices-v1.0.bin')

package/.claude/hooks/tts/repeat.py

@@ -20,7 +20,8 @@ VOICES_FILE = os.path.join(HOOK_DIR, 'voices.json')
 DAEMON_SCRIPT = os.path.join(HOOK_DIR, 'daemon.py')
 
 DAEMON_HOST = '127.0.0.1'
-DAEMON_PORT = 6254
+import hashlib as _hashlib
+DAEMON_PORT = 49152 + (int(_hashlib.md5(HOOK_DIR.encode()).hexdigest(), 16) % 16384)
 
 
 def _start_daemon():

package/.claude/hooks/tts/stop.py

@@ -21,7 +21,8 @@ VOICES_FILE = os.path.join(HOOK_DIR, 'voices.json')
 DAEMON_SCRIPT = os.path.join(HOOK_DIR, 'daemon.py')
 
 DAEMON_HOST = '127.0.0.1'
-DAEMON_PORT = 6254
+import hashlib as _hashlib
+DAEMON_PORT = 49152 + (int(_hashlib.md5(HOOK_DIR.encode()).hexdigest(), 16) % 16384)
 
 READ_ALL_CHAIN = False  # True = speak all assistant messages in chain, False = last only
 

package/.claude/hooks/tts/task-hook.py

@@ -19,7 +19,8 @@ VOICES_FILE = os.path.join(HOOK_DIR, 'voices.json')
 DAEMON_SCRIPT = os.path.join(HOOK_DIR, 'daemon.py')
 
 DAEMON_HOST = '127.0.0.1'
-DAEMON_PORT = 6254
+import hashlib as _hashlib
+DAEMON_PORT = 49152 + (int(_hashlib.md5(HOOK_DIR.encode()).hexdigest(), 16) % 16384)
 
 
 def strip_markdown(text):

package/INSTALL.md

@@ -43,7 +43,7 @@ The installer automatically:
 7. Patches `settings.json` / `settings.local.json` with hook entries (backs up original first)
 
 **Local vs global:**
-- Default (no flag): everything goes into `./.claude/` — hook scripts, commands, and `settings.local.json` (gitignored). Good for shipping TTS config alongside a project. Note: the local daemon runs on `localhost:6254`; if you have two local-installed projects open at once, they'll share the port (the first one wins).
+- Default (no flag): everything goes into `./.claude/` — hook scripts, commands, and `settings.local.json` (gitignored). Good for shipping TTS config alongside a project. Each install gets its own daemon port, so multiple local-installed projects run independently without conflict.
 - `--global`: everything goes into `~/.claude/` — hook scripts, commands, and `settings.json`. Recommended for personal use across all projects.
 
 ### Option B — installer script
@@ -290,7 +290,9 @@ Type in the Claude Code prompt:
 
 ## Daemon Protocol
 
-The daemon runs on `localhost:6254` and accepts JSON lines:
+The daemon runs on `localhost` on a port derived from the install directory (range 49152–65535). Each install location gets a stable, unique port — so multiple local-installed projects run independent daemons without conflict. Hook scripts and the daemon compute the same port, so they always find each other.
+
+Accepts JSON lines:
 
 | Command | Effect |
 |---------|--------|
@@ -347,8 +349,8 @@ The daemon auto-restarts on the next Claude response.
 - sounddevice doesn't always pull in cffi automatically
 
 ### Daemon keeps restarting / won't stay up
-- Check for port conflict: `lsof -i :6254` (Mac/Linux) or `netstat -ano | findstr 6254` (Windows)
-- Check `~/.claude/hooks/tts/daemon.log`
+- Each install uses a unique port derived from its directory path — port conflicts between installs are not possible
+- Check `daemon.log` in your hooks directory for errors
 
 ### Audio cuts off mid-sentence (kokoro fallback)
 - kokoro-onnx has a 510-token (~1500 char) hard limit

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domdhi/claude-code-tts",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Neural TTS hook system for Claude Code. Reads Claude's responses aloud as they finish.",
   "bin": {
     "claude-code-tts": "bin/install.js"