|author||Richard <email@example.com>||2021-07-10 17:08:44 +0100|
|committer||Richard <firstname.lastname@example.org>||2021-07-10 17:08:44 +0100|
1 files changed, 30 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
@@ -0,0 +1,30 @@
+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.
+ - 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
+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
+*ifn ftts Stext, ipitch*
+ - 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.