Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Text-to-speech

tagent-cli can read text aloud, with Google’s text-to-speech by default.

WhereHow
Any applicationSelect text, press the speech hotkey (Alt+S); see Hotkeys
The prompt/s <text>; /s alone repeats the last phrase, /ss its translation
The command linetagent-cli -s "Hello world"

To stop playback:

  • The speech hotkey again, while hotkey speech plays (Windows, Linux).
  • Esc, on Windows and on Linux with X11 in unified mode, where tagent-cli watches the keyboard.
  • Ctrl+C in the terminal, on Linux (all modes, Wayland included): at the prompt it stops any playback, hotkey speech too, and otherwise just gives a new prompt line.

On macOS nothing stops it yet: wait for the end.

Which language

  • Text from /s <text>, -s and the speech hotkey is read in the source language. If it is auto, the translation provider detects the language first.
  • /s and /ss without text use the languages of the last translation as they were when it was made: /s reads the phrase in its source language, /ss the translation in its target language.

Long text is read in pieces, one after another, without a long wait at the start.

Settings

[speech]
enable_text_to_speech = true   # false turns speech off everywhere
speech_hotkey = "Alt+S"        # restart required
enable_speech_hotkey = true
speech_provider = "google"

speech_provider is independent of the translation provider. Today google is the only speech provider; see How providers work.