claude-tts-hook 0.3.0

Claude Code hook that reads assistant messages aloud via a local TTS engine

claude-tts-hook

Claude Code hook that reads assistant messages aloud via a local TTS engine.

Features

• Plugs into Claude Code's MessageDisplay hook — no polling, no transcript parsing needed
• Splits long responses into chunks and speaks them sequentially
• Cleans Markdown before speaking (strips code blocks, headings, links, etc.)
• Converts English words / camelCase identifiers to katakana for natural Japanese TTS
• Multi-backend: drop in your preferred local TTS engine

Supported backends

Backend	OS	Free	Notes
Voisona Talk	Win / Mac	✓	REST API on localhost:32766
VoiceVox	Win / Mac / Linux	✓	REST API on localhost:50021

Installation

uv tool install claude-tts-hook

Or run without installing:

uvx claude-tts-hook --help

Setup

1. Create config

uvx claude-tts-hook init

This creates ~/.config/claude-tts-hook/config.json (Windows: %APPDATA%/claude-tts-hook/config.json). Edit it to set your backend and credentials:

{
  "backend": "voisona",
  "max_text_len": 500,
  "debug": false,
  "voisona": {
    "language": "ja_JP",
    "voice_name": null,
    "voice_version": null,
    "auth": "username:password",
    "poll_interval": 0.5,
    "poll_timeout": 60.0
  },
  "voicevox": {
    "speaker_id": null
  }
}

2. Pick a voice

uvx claude-tts-hook pick

3. Register as a Claude Code hook

uvx claude-tts-hook register

Or add manually to ~/.claude/settings.json:

{
  "hooks": {
    "MessageDisplay": [
      {
        "matcher": "",
        "hooks": [{ "type": "command", "command": "uvx claude-tts-hook" }]
      }
    ]
  }
}

CLI

claude-tts-hook init [--force]          # create default config
claude-tts-hook show                    # show config (password masked)
claude-tts-hook set KEY VALUE           # update a config value
claude-tts-hook voices                  # list voices from the API
claude-tts-hook pick                    # interactive voice picker
claude-tts-hook register [--command …] # register as Claude Code hook
claude-tts-hook unregister [--command …] # remove hook registration

Setting config values

Top-level keys (backend, max_text_len, debug) are set directly:

claude-tts-hook set backend voicevox
claude-tts-hook set debug true

Backend-specific keys use backend.field notation:

claude-tts-hook set voisona.auth "user:pass"
claude-tts-hook set voicevox.speaker_id 1

License

MIT