a light weight connector for espeak-ng and speakup
  • C 96.6%
  • Meson 3.4%
Find a file
Alexander Epaneshnikov 2b959e874e signal: wake all condition-variable waiters on shutdown
On SIGINT/SIGTERM, the signal thread only set should_run to 0 and
relied on a wake-up chain to propagate the shutdown: the self-pipe
wakes the softsynth thread out of select(), which on exit signals
runner_awake to wake the espeak thread.

That chain breaks whenever the softsynth thread is not sitting in
select() but waiting on stop_acknowledged in request_espeak_stop():
nobody ever signals that condition variable on shutdown, so the thread
never re-evaluates should_run and the process never exits.

Broadcast all three condition variables after clearing should_run, so
that every parked thread re-checks its predicate, whichever wait it is
blocked in.

Helps: https://github.com/linux-speakup/espeakup/issues/45
Helps: https://github.com/linux-speakup/espeakup/issues/62

Co-Authored-By: Claude <noreply@anthropic.com>
2026-06-29 10:29:36 +02:00
doc format build files consistently 2021-07-03 03:53:58 +03:00
services meson: switch from deprecated functions (#49) 2022-03-11 14:51:28 +01:00
src signal: wake all condition-variable waiters on shutdown 2026-06-29 10:29:36 +02:00
.clang-format use clang-format for code styling 2021-06-19 01:57:49 -05:00
.gitignore switch to meson (#30) 2021-06-18 21:53:04 -05:00
.indent.pro added .indent.pro to the repository 2009-05-30 00:20:31 -05:00
COPYING added gpl 2008-08-01 21:46:54 -05:00
meson.build meson: switch from deprecated functions (#49) 2022-03-11 14:51:28 +01:00
meson_options.txt format build files consistently 2021-07-03 03:53:58 +03:00
README.md Fix deprecated Meson setup command warning in README (#61) 2025-08-22 14:12:32 +03:00

espeakup connector

espeakup is a program which makes it possible for speakup to use the espeak-ng software synthesizer. It does this by reading speakup's softsynth device and passing the text to espeak-ng which actually speaks.

Requirements

This program works with the speakup screen reader, which can be obtained from http://linux-speakup.org, and the espeak-ng software speech synthesizer.

You must have both of these installed and operational. Setting them up is beyond the scope of this document.

Installation

The preferred way to install espeakup is using your distribution's packaging system, but if your distribution does not have a package for espeakup yet, espeakup just uses meson, so you should be able to change to the source directory, then type:

meson setup . ./build
cd ./build
ninja
sudo ninja install

Starting Up

This program should be run after speakup is set up to communicate with a software synthesizer and after /dev/softsynth exists. The way this is done is distribution specific, so it is beyond the scope of this documentation.

Acknowledgements

I would like to thank Marc Mulcahy, the author of the speakup to TTSynth connector, on which this work is based. Also, I would like to thank Kirk Reiser and Jonathan Duddington, the authors of Speakup and Espeak, respectively, for their work.

Filing Bugs

Bugs should be filed on our bug tracker at https://github.com/linux-speakup/issues.