gnat / text-to-speech-ubuntu

🙊 Setup "selectable" text to speech / TTS on Ubuntu Linux 24.04 22.04 22.10 23.04 23.10 . Ideal for speed reading, programming, editing and writing.

Text to Speech (TTS) Shortcut Ubuntu

For speed reading, researching, programming, editing and writing.

Tested on Ubuntu 24.04, 22.04, 22.10, 23.04, 23.10, but should work on similar distributions such as Mint, Debian, Pop OS. xsel required so espeak can read from clipboard. Works with espeak or espeak-ng.

1. sudo apt install espeak xsel -y
2. Set your custom shortcuts. See Gnome or KDE below.
3. With your mouse, select text you want read aloud, press your Read keys.

Gnome

• System Settings ➡ Keyboard ➡ Keyboard Shortcuts ➡ Custom Shortcuts ➡ +
• Read bash -c "espeak -s260 -g0 -p40 -v english-us \"$(xsel | sed -e :a -e 'N;s/\n/ /;ta')\""
• Stop Reading bash -c "killall espeak"
• Recommended keys SUPER + R (Read) and SHIFT + SUPER + R (Stop Reading)
• With your mouse, select text you want read aloud, press your Read keys.

KDE

KDE is a little different because custom shortcuts have an issue with multiple commands in the same action, but this works:

• System Settings ➡ Shortcuts ➡ Custom Shortcuts ➡ Edit .. New .. Global .. Command
• Read xsel > /tmp/speak.txt | espeak -s260 -g0 -p40 -v english-us -f /tmp/speak.txt
• Stop Reading killall espeak
• Recommended keys SUPER + R (Read) and SHIFT + SUPER + R (Stop Reading)
• With your mouse, select text you want read aloud, press your Read keys.

Options

• -s260 Speed of reading (260 is faster).
• -g0 Delay between words (0 is no delay).
• -p40 Pitch (50 is normal).
• -v english-us Voice pack (en-us for espeak-ng).

Sed explainer.

The sed is required to replace newlines properly. Reference: https://linux.die.net/man/1/sed

• -e :a Sets a label for looping.
• N Read next line into substitute buffer ... or $!N ($ go to EOL, !N exit if no more newlines to read)
• ;s/\n/ / Substitute newlines with space.
• ;ta Loop to label a.

Using espeak-ng instead of espeak

Some distributions come with espeak-ng which can be used with only minor changes.

1. Read bash -c "espeak-ng -s260 -g0 -p40 -v en-us \"$(xsel | sed -e :a -e 'N;s/\n/ /;ta')\""
2. Stop Reading bash -c "killall espeak-ng"

Killing espeak if needed.

• ps -ef | grep "espeak" | tr -s ' ' | cut -d ' ' -f2 | xargs kill -9

Why?

Because my favorite TTS reader gespeaker (python frontend to espeak) is unmaintained, and most other options suck or are browser only.

text-to-speech-ubuntu's Issues

Thx for making this. Have been looking for a tts solution like this in ubuntu for ages