From 6fc410cbb8e1a46f9a41ec47cc1993051878fd44 Mon Sep 17 00:00:00 2001 From: Richard Date: Sat, 10 Jul 2021 17:08:44 +0100 Subject: added readme --- README.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..26599f1 --- /dev/null +++ b/README.md @@ -0,0 +1,30 @@ +## Introduction +csound-festival provides a simple way of generating speech using the TTS engine Festival. It runs an init time and generates a ftable containing the synthesised speech which can then be used elsewhere. Currently only pitch is a supported parameter but there is certainly scope for adding further parameters. +The opcode has only been tested on Linux as of writing. + + +## Requirements + - Csound development libraries + - [Festival](https://www.cstr.ed.ac.uk/projects/festival/) which also depends on [The Edinburgh Speech Tools Library](https://www.cstr.ed.ac.uk/projects/speech_tools/), both probably handled by your relevant package manager. + - Cmake 3.8 or later + + +## Building +Create a build directory at the top of the source tree, execute *cmake ..*, *make* and optionally *make install* as root. If the latter is not used/possible then the resulting libnstrexists module can be used with the *--opcode-lib* flag in Csound. eg: + + cd csound-festival + mkdir build && cd build + cmake .. + make && sudo make install + + +## Opcode overview +### ftts +*ifn ftts Stext, ipitch* + +Generate speech + + - ifn : the function table number as created containing the generated speech + - Stext : the text string to synthesise + - ipitch : the fundamental frequency for synthesis in CPS. + -- cgit v1.2.3