Skip to content

About

🎙️ Local TTS for Claude Code — a macOS menu-bar app that speaks the last paragraph of each answer (Russian + English), fully offline.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

Claude Voice

RU: Локальная озвучка ответов Claude Code из строки меню macOS.
EN: Local text-to-speech for Claude Code replies from the macOS menu bar.

Русский · English

macOS 14+ · Apple Silicon Swift Engine: sherpa-onnx License: MIT Latest release


RU

Claude Voice читает вслух финальный абзац ответа Claude Code приятным локальным голосом. Приложение работает полностью офлайн: без облачной модели, без сетевых запросов и без сбора данных.

Возможности

  • Озвучивает только финальный ответ, чтобы не читать промежуточный шум.
  • Поддерживает русский и английский с автоопределением языка абзаца.
  • Останавливает голос при нажатии клавиши в терминале с Claude Code.
  • Нормализует русские числа и добавляет ударения через словарь на 3.2 млн словоформ.
  • Использует sherpa-onnx и голоса Piper; синтез обычно быстрее реального времени.
  • Позволяет выбрать RU/EN голос, число CPU-потоков, автозапуск и язык интерфейса прямо в меню.

Установка

  1. Скачайте ClaudeVoice-x.y.z.dmg на странице Releases.
  2. Откройте DMG и запустите Install.command.
  3. Если macOS блокирует запуск, кликните по Install.command правой кнопкой и выберите Открыть.
  4. После запуска разрешите Input Monitoring / Отслеживание ввода и установите хук Claude Code из меню.
  5. Откройте новую сессию Claude Code. Хуки читаются при старте новой сессии.

Требования: Apple Silicon, macOS 14+.

Меню в строке меню

Пункт Назначение
Озвучка включена Главный переключатель озвучки
Голос (русский) / Voice (Russian) Выбор русского голоса
Голос (английский) / Voice (English) Выбор английского голоса
CPU-потоки Ограничение числа потоков синтеза
Язык интерфейса Переключение меню между RU и EN
Проверить голос Быстрый тест выбранного языка интерфейса
Установить хук Интеграция с Claude Code
Запускать при входе Автозапуск приложения

Как это работает

flowchart LR
    A[Claude Code завершил ответ] --> B[Stop hook]
    B --> C[POST на 127.0.0.1]
    C --> D[Последний абзац transcript]
    D --> E{Язык}
    E -- RU --> F[Числа и ударения]
    E -- EN --> G[Текст как есть]
    F --> H[sherpa-onnx + Piper]
    G --> H
    H --> I[Воспроизведение]
    K[Клавиша в терминале Claude Code] -. stop .-> I
Loading

Хук добавляется в ~/.claude/settings.json с резервной копией. Команда хука помечена src=claude-voice-tts, использует локальный curl с таймаутом и не блокирует Claude Code.

Сборка из исходников

bash packaging/fetch_assets.sh
bash packaging/build_app.sh 0.1.0
bash packaging/make_dmg.sh 0.1.0

Быстрая проверка без GUI:

swift build -c release
DYLD_LIBRARY_PATH="$PWD/vendor/lib" CLAUDEVOICE_RESOURCES="$PWD/Resources" \
  ./.build/release/ClaudeVoice --selftest

Ограничения

  • Сборка не подписана Developer ID, поэтому Gatekeeper требует ручного подтверждения при первом запуске.
  • После обновления macOS может снова запросить разрешение Input Monitoring.
  • Поддерживается только Apple Silicon.
  • Лицензия русского голоса ru_RU-irina указана как Unknown; используйте с учётом этого ограничения.

Что можно улучшить дальше

  • Добавить Developer ID подпись и notarization в release pipeline.
  • Вынести локализацию из словаря L в .strings, если меню станет заметно больше.
  • Добавить unit-тесты для TranscriptReader, LanguageDetector, HookInstaller и русской нормализации.
  • Сделать отдельные тесты голосов RU/EN в меню вместо одного пункта Проверить голос.

EN

Claude Voice speaks the final paragraph of each Claude Code answer with a local voice. It runs fully offline: no cloud TTS, no network calls, and no data collection.

Features

  • Speaks only the final answer to avoid intermediate noise.
  • Supports Russian and English with automatic paragraph language detection.
  • Stops playback when you press a key in the terminal running Claude Code.
  • Normalizes Russian numbers and applies stress marks using a 3.2M-word-form dictionary.
  • Uses sherpa-onnx and Piper voices; synthesis is usually faster than real time.
  • Lets you choose RU/EN voices, CPU thread count, launch at login, and interface language from the menu bar.

Installation

  1. Download ClaudeVoice-x.y.z.dmg from Releases.
  2. Open the DMG and run Install.command.
  3. If macOS blocks it, right-click Install.command and choose Open.
  4. After launch, allow Input Monitoring and install the Claude Code hook from the menu.
  5. Open a new Claude Code session. Hooks are loaded when a new session starts.

Requirements: Apple Silicon, macOS 14+.

Menu Bar

Item Purpose
Speech enabled Master speech toggle
Voice (Russian) / Голос (русский) Russian voice selection
Voice (English) / Голос (английский) English voice selection
CPU threads Synthesis thread limit
Interface language Switch the menu between EN and RU
Test voice Quick test for the selected interface language
Install Claude Code hook Claude Code integration
Launch at login Start the app on login

How It Works

flowchart LR
    A[Claude Code finishes an answer] --> B[Stop hook]
    B --> C[POST to 127.0.0.1]
    C --> D[Last transcript paragraph]
    D --> E{Language}
    E -- RU --> F[Numbers and stress marks]
    E -- EN --> G[Text as-is]
    F --> H[sherpa-onnx + Piper]
    G --> H
    H --> I[Playback]
    K[Key press in Claude Code terminal] -. stop .-> I
Loading

The hook is added to ~/.claude/settings.json with a backup. It is marked with src=claude-voice-tts, uses a local curl call with a timeout, and does not block Claude Code.

Build From Source

bash packaging/fetch_assets.sh
bash packaging/build_app.sh 0.1.0
bash packaging/make_dmg.sh 0.1.0

Quick non-GUI check:

swift build -c release
DYLD_LIBRARY_PATH="$PWD/vendor/lib" CLAUDEVOICE_RESOURCES="$PWD/Resources" \
  ./.build/release/ClaudeVoice --selftest

Limitations

  • The app is not signed with a Developer ID, so Gatekeeper requires a manual confirmation on first launch.
  • macOS may ask for Input Monitoring permission again after updates.
  • Apple Silicon only.
  • The Russian voice ru_RU-irina is marked with an Unknown license; use it with that limitation in mind.

Possible Improvements

  • Add Developer ID signing and notarization to the release pipeline.
  • Move localization from the compact L dictionary to .strings if the menu grows.
  • Add unit tests for TranscriptReader, LanguageDetector, HookInstaller, and Russian normalization.
  • Add separate RU/EN voice test menu items instead of a single Test voice command.

Licenses

Component License
App code MIT
sherpa-onnx / ONNX Runtime Apache-2.0 / MIT
en_US-libritts_r voice CC BY 4.0
ru_RU-irina voice Unknown
espeak-ng GPL-3.0
RUAccent dictionaries Apache-2.0

About

🎙️ Local TTS for Claude Code — a macOS menu-bar app that speaks the last paragraph of each answer (Russian + English), fully offline.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages