dsh-voice-announcer

Configuration

Option 1: Web settings UI (recommended)

Open Settings → Plugin configuration → Voice announcement in the sidebar. Edits are applied live after saving.

Option 2: Config file

Append the following to ~/.dsh/profiles/ /cordis.patch.yml:

- id: dsh-voice-announcer
  config:
    enabled: true
    engine: edge-tts        # edge-tts / sapi
    voice: auto              # auto: follow UI language; or a specific voice id
    announceCompleted: true
    announceError: true
    announceSubagent: false  # announce subagent sessions too
    liveRead: false          # live-read replies as they stream in (edge-tts only)
    liveReadActiveOnly: true # live-read only the currently active session

Options

Option	Default	Description
enabled	true	Master switch
engine	edge-tts	Engine; voice/rate/pitch controls are disabled when sapi is selected
voice	auto	Voice id (edge-tts only), see below; auto picks by UI language (zh→Xiaoxiao, en→Aria) when unset
rate	+0%	Speech rate (edge-tts), slider -50% ~ +50%
pitch	+0Hz	Speech pitch (edge-tts), slider -50Hz ~ +50Hz
announceCompleted	true	Announce normal completion
announceError	true	Announce errors, aborts, and truncations
announceSubagent	false	Announce subagent sessions too
liveRead	false	Live-read replies sentence by sentence while they stream (edge-tts only)
liveReadActiveOnly	true	Live-read only the currently active session (the browser reports it)