-
-
Notifications
You must be signed in to change notification settings - Fork 25
/
hear.1.html
73 lines (50 loc) · 2.71 KB
/
hear.1.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
<html><head></head><body><pre><font face="Courier"><b>HEAR(1) General Commands Manual HEAR(1)</b>
<b>NAME</b>
<b>hear</b> – macOS speech recognition via the command line
<b>SYNOPSIS</b>
<b>hear</b> [<b>-hvdmps</b>] [<b>-i</b> <u>audio</u><b>_<u></b>file</u>] [<b>-l</b> <u>locale</u>] [<b>-x</b> <u>exit</u><b>_<u></b>word</u>]
<b>DESCRIPTION</b>
<b>hear</b> is a command line interface for the built-in speech recognition
capabilities in macOS. It supports transcription of both audio files and
microphone input. If no input file is provided, the default behaviour is
to transcribe from the default audio input device, typically the
microphone.
The following flags are supported:
<b>-s</b> <b>--supported</b>
Print list of supported locales for speech recognition and exit.
<b>-l</b> <b>--locale</b> <u>loc</u>
Specify speech recognition language (locale). Default is 'en-
US'.
<b>-i</b> <b>--input</b> <u>audio</u><b>_<u></b>file</u>
Input audio file. All formats supported by CoreAudio should work
(e.g. WAV, MP3, AAC, CAF, AIFF, ALAC, etc.).
<b>-d</b> <b>--device</b>
Only use on-device offline speech recognition. The default is to
use whatever the macOS Speech Recognition API thinks is best,
which may include sending data to Apple servers. When on-device
is not enabled, there may be a hard limit to the length of audio
that can be transcribed in a single session. As of writing
(2023) this is about 500 characters or so.
<b>-m</b> <b>--mode</b>
Enable single-line output mode (only applies when the input is
default audio input device, e.g. microphone).
<b>-p</b> <b>--punctuation</b>
Add punctuation to speech recognition results.
<b>-x</b> <b>--exit</b> <u>exit</u><b>_<u></b>word</u>
Set exit word. This causes the program to exit when a speech
recognition result ends with the specified word.
<b>-t</b> <b>--timeout</b> <u>seconds</u>
Exit if no recognition results are received within the specified
number of seconds.
<b>-h</b> <b>--help</b>
Print help and exit.
<b>-v</b> <b>--version</b>
Print program name and version, and exit.
Returns 0 on success and greater than 0 on error or failure.
<b>SEE ALSO</b>
say(1) afplay(1)
<b>AUTHORS</b>
Sveinbjorn Thordarson <[email protected]>
Darwin October 27, 2023 Darwin
</font></pre>
</body></html>