FESTIVAL(1)

📦
version 2.5.0 · 3 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 FESTIVAL(1) 💖

okay bestie, sit down, we're doing the General Commands Manual thing and it's giving iconic. this is festival, and she is a whole text-to-speech system ✨

🌸 NAME 🌸

festival — a text-to-speech system. that's it, that's the girl. 💅

🎀 SYNOPSIS 🎀

festival [options] [file0] [file1] ...

🦋 DESCRIPTION 🦋

so festival is a general purpose text-to-speech system, no cap. and like, yeah she renders text as speech, but that's not even her whole personality — she can also live in an interactive command mode for testing and developing various aspects of speech synthesis technology. main character energy fr fr 🔥

she's got two major modes: command and tts (which is text-to-speech, duh 💀).

  • in command mode, input — whether it's from a file or interactive — gets interpreted by the command interpreter.
  • in tts mode, input gets rendered as speech.

and here's a lil detail that's lowkey important: when you're in command mode, filenames that start with a left parenthesis are treated as literal commands and evaluated. periodt. 🫶

✨ OPTIONS ✨

  • -q — load no default setup files. clean slate vibes.
  • --datadir <string> — set the data directory pathname. tell her where her stuff lives.
  • --libdir <string> — set the library directory pathname.
  • -b — run in batch mode (no interaction). no chatting, just vibes.
  • --batch — run in batch mode (no interaction). same energy, longer spelling 💖
  • --tts — synthesize text in files as speech. no files means read from stdin. and heads up, this implies no interaction by default.
  • -i — run in interactive mode (and yes, that's the default).
  • --interactive — run in interactive mode (default). she wants to talk to you 🥺
  • --pipe — run in pipe mode, reading commands from stdin, but no prompt or return values are printed. this is the default if stdin is not a tty.
  • --language <string> — run in a named language. default is english, but spanish, russian, welsh and others are available. multilingual queen 👑
  • --server — run in server mode, waiting for clients of server_port (1314). she's on aux, waiting for her callers 📞
  • --script <ifile> — used in #! scripts, runs in batch mode on file and passes all other args to Scheme. shebang-coded ⭐
  • --heap <int> {10000000} — set size of Lisp heap. and listen, you should not normally need to change this from its default, okay? leave her alone 🙈
  • -v — display version number and exit.
  • --version — display version number and exit. same thing, extra syllables 💜

💀 BUGS 💀

More than you can imagine.

literally. more than you can imagine. not me being honest in a manpage 😭

a manual with much detail (though not complete) is available in distributed as part of the system, and it's also accessible at http://www.cstr.ed.ac.uk/projects/festival/manual/ 🧚

and even though we cannot guarantee the time required to fix bugs, we would appreciated it if they were reported to festival-bug@cstr.ed.ac.uk. (yes, "would appreciated" — we're keeping the original's whole vibe, don't @ me 🍓)

🌈 AUTHOR 🌈

Alan W Black, Richard Caley and Paul Taylor (C) Centre for Speech Technology Research, 1996-1998 University of Edinburgh 80 South Bridge Edinburgh EH1 1HN http://www.cstr.ed.ac.uk/projects/festival.html

and that's the whole page bestie!! this was written on the 6th Apr 1998, it's part of General Commands Manual, and it's literally called FESTIVAL(1) — go forth and make her speak 💖✨🎀

📦 where this page comes from