README for Pd external distribution 'pd-flite'

Last updated for version 0.3.3

DESCRIPTION

The 'pd-flite' distribution contains a single Pd external ("flite"), which provides a high-level text-to-speech interface for English based on the 'libflite' library by Alan W Black and Kevin A. Lenzo.

'libflite' lives at https://github.com/festvox/flite

linking with libflite

To produce a self-contained "flite" external (with no external dependencies on libflite), you can statically link the library.

git submodules

The libflite sources are available via a git submodule in deps/flite/.

After cloning the pd-flite repository, initialize the submodules via:

git submodule update --init

If the submodule is updated, re-run git submodule update in your local clone to get the lastest and greatest libflite.

without git

If you obtained the 'pd-flite' sources without git (e.g. by downloading a release tarball), there won't be any bundled libflite. Instead, you can manually download flite from https://github.com/festvox/flite and put it into the deps/flite/ folder (so you have a deps/flite/include/flite.h file)

use system libraries

If you prefer to use system-provided libflite instead (e.g. provided by your favourite package manager), just make sure that deps/flite/ is empty (by not initializing the git-submodules and not downloading libflite manually). If the build process does not detect the deps/flite/include/flite.h file, it will attempt to use a system-provided libflite instead.

If you happen to have a local copy of libflite in the deps/ folder, you can force building against the system libraries by adding use_bundled_flite=no when calling make.

WINDOWS BUILD

With MSYS2 install the ntldd package:

pacman -S mingw32/mingw-w64-i686-ntldd-git

pacman -S mingw64/mingw-w64-x86_64-ntldd-git

Then cd MinGW to this repo and do:

make

or you can also specify more options with:

make PDDIR=<path/to/pd-directory>

then do this command that installs and fills the pthread dependencies on the output dir:

make localdep_windows

or with more options:

make PDLIBDIR=<path/you/want-the/output> extension=<m_i386 or m_amd64> localdep_windows

ACKNOWLEDGEMENTS

Pd by Miller Puckette and others.

Flite run-time speech synthesis library by Alan W Black and Kevin A. Lenzo.

Ideas, black magic, and other nuggets of information drawn from code by Guenter Geiger, Larry Troxler, and iohannes m zmoelnig.

KNOWN BUGS

It gobbles memory, and also processor time on synthesis operations.

AUTHOR

Bryan Jurish [email protected]

MAINTENANCE

Since v0.3.0 Lucas Cordiviola https://github.com/pd-externals/flite

• Thanks to Christof Ressi for code reviews.