PocketSphinx 5.0.1

Installation

python3 -m venv ~/ve_pocketsphinx
. ~/ve_pocketsphinx/bin/activate
pip install .

cmake -S . -B build
cmake --build build
cmake --build build --target install

Usage

• help: Print a long list of those options you don't care about.
• config: Dump configuration as JSON to standard output (can be loaded with the -config option).
• live: Detect speech segments in each input, run recognition on them (using those options you don't care about), and write the results to standard output in line-delimited JSON. I realize this isn't the prettiest format, but it sure beats XML. Each line contains a JSON object with these fields, which have short names to make the lines more readable:
  • b: Start time in seconds, from the beginning of the stream
  • d: Duration in seconds
  • p: Estimated probability of the recognition result, i.e. a number between 0 and 1 representing the likelihood of the input according to the model
  • t: Full text of recognition result
  • w: List of segments (usually words), each of which in turn contains the b, d, p, and t fields, for start, end, probability, and the text of the word. If -phone_align yes has been passed, then a w field will be present containing phone segmentations, in the same format.
• single: Recognize each input as a single utterance, and write a JSON object in the same format described above.
• align: Align a single input file (or - for standard input) to a word sequence, and write a JSON object in the same format described above. The first positional argument is the input, and all subsequent ones are concatenated to make the text, to avoid surprises if you forget to quote it. You are responsible for normalizing the text to remove punctuation, uppercase, centipedes, etc. For example:
  pocketsphinx align goforward.wav "go forward ten meters"
  By default, only word-level alignment is done. To get phone alignments, pass -phone_align yes in the flags, e.g.:
  pocketsphinx -phone_align yes align audio.wav $text
  This will make not particularly readable output, but you can use jq to clean it up. For example, you can get just the word names and start times like this:
  pocketsphinx align audio.wav $text | jq '.w[]|[.t,.b]'
  Or you could get the phone names and durations like this:
  pocketsphinx -phone_align yes align audio.wav $text | jq '.w[]|.w[]|[.t,.d]'
  There are many, many other possibilities, of course.
• soxflags: Return arguments to sox which will create the appropriate input format. Note that because the sox command-line is slightly quirky these must always come after the filename or -d (which tells sox to read from the microphone). You can run live recognition like this:
  sox -d $(pocketsphinx soxflags) | pocketsphinx -
  or decode from a file named "audio.mp3" like this:
  sox audio.mp3 $(pocketsphinx soxflags) | pocketsphinx -

Programming

Authors