@@ -7,18 +7,25 @@ SayIt is a cross-platform command line tool that pronounces written text.
7
7
You can use it to create audio recordings of your text files or
8
8
to improve your pronunciation in a foreign language.
9
9
10
- ## Installation
10
+ ## Setup
11
11
12
12
SayIt uses [ Azure Cognitive Services] [ az-cs ] as backend to guarantee
13
13
optimal audio quality, so it requires a subscription to Azure, which you can get for free
14
14
[ here] [ az-sub ] .
15
- Azure Cognitive Services [ free tier] [ az-cs-price ] includes 5 text-to-speech
15
+ Azure Cognitive Services [ free tier] [ az-cs-price ] , as of 2021, includes 5 text-to-speech
16
16
hours per month, which is often enough for personal use.
17
17
18
18
You can download SayIt in the [ release section] [ release ] .
19
19
SayIt is currently distributed both as self-contained .NET executable
20
20
(which means you won't need to install the .NET runtime to use it)
21
- and as framework-dependent .NET 5 executable.
21
+ and as framework-dependent .NET executable.
22
+
23
+ At the first use you're required to run the setup wizard (` ./sayit --setup ` )
24
+ and enter the configuration parameters of your Azure Cognitive Services resource,
25
+ such as the subscription key (which you can find in the Azure portal)
26
+ and the region identifier (see [ here] [ region-ids ] ).
27
+ SayIt will store these parameters in the configuration folder of the current
28
+ user (e.g. ` ~/.config/ ` in Linux) as an [ App Setting XML file] [ appsetting ] .
22
29
23
30
## Usage
24
31
@@ -45,19 +52,13 @@ OPTIONS:
45
52
--output, -o <output> the path of the output file
46
53
--help display this list of options.
47
54
```
48
- At the first use you're required to run the setup wizard (` ./sayit --setup ` )
49
- and enter the configuration parameters of your Azure Cognitive Services resource,
50
- such as the subscription key (which you can find in the Azure portal)
51
- and the region identifier (see [ here] [ region-ids ] ).
52
- SayIt will store these parameters in the configuration folder of the current
53
- user (e.g. ` ~/.config/ ` in Linux) as an [ App Setting XML file] [ appsetting ] .
54
55
55
56
SayIt supports these settings:
56
57
- [ languages] [ voices ] : English, Italian, French, German, Spanish, Hindi, Portuguese, Russian, Japanese and Chinese (Mandarin).
57
58
- [ output formats] [ output-formats ] : ` audio-16khz-32kbitrate-mono-mp3 ` , ` audio-16khz-64kbitrate-mono-mp3 ` , ` audio-16khz-128kbitrate-mono-mp3 ` , ` audio-24khz-96kbitrate-mono-mp3 ` , ` audio-24khz-160kbitrate-mono-mp3 ` , ` audio-24khz-48kbitrate-mono-mp3 ` , ` riff-8khz-16bit-mono-pcm ` , ` riff-16khz-16bit-mono-pcm ` , ` riff-24khz-16bit-mono-pcm ` .
58
59
59
- > NB: some languages and output formats might not be supported by your Azure Cognitive Services resource,
60
- depending on its region (see [ here] [ region-voices ] ).
60
+ > NB: some languages and output formats might not be supported by your
61
+ Azure Cognitive Services resource, depending on its region (see [ here] [ region-voices ] ).
61
62
62
63
> NB: the choice of supported voices and formats has been somewhat random. I
63
64
> welcome suggestions and contributions, of course.
0 commit comments