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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
.TH man 1 "04 August 2017" "1.2.0" "gtts-cli manpage"
.SH NAME
gtts-cli \- convert text to mp3
.SH SYNOPSIS
gtts-cli [-h | --help] (["text to speak"] | -f FILE | --file FILE) [-o DESTINATION_FILE | --destination DESTINATION_FILE] [-l LANG | --lang LANG] [--slow] [--debug]
.SH DESCRIPTION
Create an mp3 file from your text with the gtts-cli command line utility. It allows unlimited lengths to be spoken by tokenizing long sentences where the speech would naturally pause.
.SH OPTIONS
.TP
.B [-h | --help]
Prints a help message and exits.
.TP
.B (["text to speak"] | -f FILE | --file FILE)
If given text in quotes, generates an mp3 with that text spoken. With -f FILE, generates the mp3 with the text from FILE.
.TP
.B (-o DESTINATION_FILE | --destination DESTINATION_FILE)
The file to write the generated mp3 to. If not given, writes to stdout (probably not what you want!)
.TP
.B (-l LANG | --lang LANG)
Which language to speak the given text in.
Supported languages are:
.TP
* 'af' : 'Afrikaans'
.TP
* 'sq' : 'Albanian'
.TP
* 'ar' : 'Arabic'
.TP
* 'hy' : 'Armenian'
.TP
* 'bn' : 'Bengali'
.TP
* 'ca' : 'Catalan'
.TP
* 'zh' : 'Chinese'
.TP
* 'zh-cn' : 'Chinese (Mandarin/China)'
.TP
* 'zh-tw' : 'Chinese (Mandarin/Taiwan)'
.TP
* 'zh-yue' : 'Chinese (Cantonese)'
.TP
* 'hr' : 'Croatian'
.TP
* 'cs' : 'Czech'
.TP
* 'da' : 'Danish'
.TP
* 'nl' : 'Dutch'
.TP
* 'en' : 'English'
.TP
* 'en-au' : 'English (Australia)'
.TP
* 'en-uk' : 'English (United Kingdom)'
.TP
* 'en-us' : 'English (United States)'
.TP
* 'eo' : 'Esperanto'
.TP
* 'fi' : 'Finnish'
.TP
* 'fr' : 'French'
.TP
* 'de' : 'German'
.TP
* 'el' : 'Greek'
.TP
* 'hi' : 'Hindi'
.TP
* 'hu' : 'Hungarian'
.TP
* 'is' : 'Icelandic'
.TP
* 'id' : 'Indonesian'
.TP
* 'it' : 'Italian'
.TP
* 'ja' : 'Japanese'
.TP
* 'km' : 'Khmer (Cambodian)'
.TP
* 'ko' : 'Korean'
.TP
* 'la' : 'Latin'
.TP
* 'lv' : 'Latvian'
.TP
* 'mk' : 'Macedonian'
.TP
* 'no' : 'Norwegian'
.TP
* 'pl' : 'Polish'
.TP
* 'pt' : 'Portuguese'
.TP
* 'ro' : 'Romanian'
.TP
* 'ru' : 'Russian'
.TP
* 'sr' : 'Serbian'
.TP
* 'si' : 'Sinhala'
.TP
* 'sk' : 'Slovak'
.TP
* 'es' : 'Spanish'
.TP
* 'es-es' : 'Spanish (Spain)'
.TP
* 'es-us' : 'Spanish (United States)'
.TP
* 'sw' : 'Swahili'
.TP
* 'sv' : 'Swedish'
.TP
* 'ta' : 'Tamil'
.TP
* 'th' : 'Thai'
.TP
* 'tr' : 'Turkish'
.TP
* 'uk' : 'Ukrainian'
.TP
* 'vi' : 'Vietnamese'
.TP
* 'cy' : 'Welsh'
.TP
.B --slow
Slower read speed for the text.
.TP
.B --debug
Print debug statements.
.SH EXAMPLES
Read the string 'Hello' in English to hello.mp3
.PP
.nf
.RS
gtts-cli "Hello" -l 'en' -o hello.mp3
.RE
.fi
.PP
Read the string 'Hello' in English (slow speed) to hello.mp3
.PP
.nf
.RS
gtts-cli "Hello" -l 'en' -o hello.mp3 --slow
.RE
.fi
.PP
Read the contents of file 'hello.txt' in Czech to hello.mp3:
.PP
.nf
.RS
gtts-cli -f hello.txt -l 'cs' -o hello.mp3
.RE
.fi
.PP
Read the string 'Hello' from stdin in English to hello.mp3
.PP
.nf
.RS
echo "Hello" | gtts-cli -l 'en' -o hello.mp3 -
.RE
.fi
.PP
.SH SEE ALSO
.SH BUGS
No known bugs.
.SH AUTHOR
Ethan Ward <ethan.ward@mycroft.ai>
|
